Skip to main content
Version: 2.1.0

Update-MtM365AdvisorApp

SYNOPSIS​

Updates an existing M365Advisor application with the latest required permissions.

SYNTAX​

ById​

Update-MtM365AdvisorApp -Id <String> [-SendMail] [-SendTeamsMessage] [-Privileged] [-Scopes <String[]>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

ByApplicationId​

Update-MtM365AdvisorApp -AppId <String> [-SendMail] [-SendTeamsMessage] [-Privileged] [-Scopes <String[]>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Updates an existing M365Advisor application in Azure AD/Entra ID with the current set of required Graph API permissions. This is useful when new permissions are added to M365Advisor and existing applications need to be updated to include them.

EXAMPLES​

EXAMPLE 1​

Update-MtM365AdvisorApp -AppId "12345678-1234-1234-1234-123456789012"

Updates the specified M365Advisor app with the current default permissions.

EXAMPLE 2​

Update-MtM365AdvisorApp -AppId "12345678-1234-1234-1234-123456789012" -SendMail -Privileged

Updates the specified M365Advisor app with mail sending and privileged capabilities.

EXAMPLE 3​

Update-MtM365AdvisorApp -AppId "12345678-1234-1234-1234-123456789012" -Scopes @("User.Read.All")

Updates the specified M365Advisor app with additional custom scopes.

PARAMETERS​

-Id​

The ID of the M365Advisor app to update

Type: String
Parameter Sets: ById
Aliases: ObjectId

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

-AppId​

The Application (Client) ID of the M365Advisor app to update

Type: String
Parameter Sets: ByApplicationId
Aliases: ClientId

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

-SendMail​

If specified, includes the Mail.Send permission scope.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SendTeamsMessage​

If specified, includes the ChannelMessage.Send permission scope.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Privileged​

If specified, includes privileged permission scopes for read-write operations.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Scopes​

Additional custom permission scopes to include beyond the default M365Advisor scopes.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-ProgressAction​

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
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​

https://m365advisor.dev/docs/commands/Update-MtM365AdvisorApp