Update-MtMaesterApp
SYNOPSIS
Section titled “SYNOPSIS”Updates an existing Maester application with the latest required permissions.
SYNTAX
Section titled “SYNTAX”Update-MtMaesterApp -Id <String> [-SendMail] [-SendTeamsMessage] [-Privileged] [-Scopes <String[]>] [-ProgressAction <ActionPreference>] [<CommonParameters>]ByApplicationId
Section titled “ByApplicationId”Update-MtMaesterApp -AppId <String> [-SendMail] [-SendTeamsMessage] [-Privileged] [-Scopes <String[]>] [-ProgressAction <ActionPreference>] [<CommonParameters>]DESCRIPTION
Section titled “DESCRIPTION”Updates an existing Maester application in Azure AD/Entra ID with the current set of required Graph API permissions. This is useful when new permissions are added to Maester and existing applications need to be updated to include them.
EXAMPLES
Section titled “EXAMPLES”EXAMPLE 1
Section titled “EXAMPLE 1”Update-MtMaesterApp -AppId "12345678-1234-1234-1234-123456789012"Updates the specified Maester app with the current default permissions.
EXAMPLE 2
Section titled “EXAMPLE 2”Update-MtMaesterApp -AppId "12345678-1234-1234-1234-123456789012" -SendMail -PrivilegedUpdates the specified Maester app with mail sending and privileged capabilities.
EXAMPLE 3
Section titled “EXAMPLE 3”Update-MtMaesterApp -AppId "12345678-1234-1234-1234-123456789012" -Scopes @("User.Read.All")Updates the specified Maester app with additional custom scopes.
PARAMETERS
Section titled “PARAMETERS”The ID of the Maester app to update
Type: StringParameter Sets: ByIdAliases: ObjectId
Required: TruePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False-AppId
Section titled “-AppId”The Application (Client) ID of the Maester app to update
Type: StringParameter Sets: ByApplicationIdAliases: ClientId
Required: TruePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False-SendMail
Section titled “-SendMail”If specified, includes the Mail.Send permission scope.
Type: SwitchParameterParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: FalseAccept pipeline input: FalseAccept wildcard characters: False-SendTeamsMessage
Section titled “-SendTeamsMessage”If specified, includes the ChannelMessage.Send permission scope.
Type: SwitchParameterParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: FalseAccept pipeline input: FalseAccept wildcard characters: False-Privileged
Section titled “-Privileged”If specified, includes privileged permission scopes for read-write operations.
Type: SwitchParameterParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: FalseAccept pipeline input: FalseAccept wildcard characters: False-Scopes
Section titled “-Scopes”Additional custom permission scopes to include beyond the default Maester scopes.
Type: String[]Parameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: @()Accept pipeline input: FalseAccept wildcard characters: False-ProgressAction
Section titled “-ProgressAction”Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.
Type: ActionPreferenceParameter Sets: (All)Aliases: proga
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: FalseCommonParameters
Section titled “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.