Skip to main content

​
SYNOPSIS

Sets the status of an enterprise application (service principal) in Microsoft Graph by setting its ‘AccountEnabled’ property.

​
SYNTAX

​
ByApplicationID

Set-MgEnterpriseAppStatus [-ApplicationID] <String> [-Status] <String> [-GenerateCmdlets]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

​
ByDisplayName

Set-MgEnterpriseAppStatus [-DisplayName] <String> [-Status] <String> [-GenerateCmdlets]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

​
DESCRIPTION

This function takes an Application ID or DisplayName as input and enables or disables the service principal (enterprise app) by using Invoke-MgGraphRequest to set AccountEnabled to true or false.

​
EXAMPLES

​
EXAMPLE 1

Set-MgEnterpriseAppStatus -ApplicationID "12345678-1234-1234-1234-123456789012" -Status "Disabled"
This command disables the enterprise application with the specified App ID.

​
EXAMPLE 2

Set-MgEnterpriseAppStatus -DisplayName "MyApp" -Status "Enabled"
This command enables the enterprise application with the specified display name.

​
PARAMETERS

​
-ApplicationID

The App ID of the service principal to modify. 
Type: String
Parameter Sets: ByApplicationID
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-DisplayName

The display name of the service principal to modify. 
Type: String
Parameter Sets: ByDisplayName
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-Status

The status to set for the enterprise application. Valid values are ‘Enabled’ or ‘Disabled’. 
Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-GenerateCmdlets

If specified, the function will generate the cmdlets and save them to a file instead of executing them. 
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

​
CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

​
INPUTS

​
OUTPUTS

​
NOTES

To modify a registered application, use the Set-MgRegisteredAppStatus function instead. https://ps365.clidsys.com/docs/commands/Set-MgEnterpriseAppStatus