Skip to main content
Version: 2.2.0

Get-MtMaesterApp

SYNOPSIS​

Retrieves Maester applications from Azure AD/Entra ID.

SYNTAX​

ById​

Get-MtMaesterApp -Id <String> [-ProgressAction <ActionPreference>] [<CommonParameters>]

ByApplicationId​

Get-MtMaesterApp -AppId <String> [-ProgressAction <ActionPreference>] [<CommonParameters>]

Default​

Get-MtMaesterApp [-Name <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Retrieves all applications in Azure AD/Entra ID that have been tagged as Maester applications. This includes applications created by New-MtMaesterApp or manually tagged with 'maester'.

EXAMPLES​

EXAMPLE 1​

Get-MtMaesterApp

Retrieves all Maester applications in the tenant.

EXAMPLE 2​

Get-MtMaesterApp -AppId "12345678-1234-1234-1234-123456789012"

Retrieves the specific Maester application with the given Application ID.

EXAMPLE 3​

Get-MtMaesterApp -Name "DevOps"

Retrieves all Maester applications that start with "DevOps" in their display name.

PARAMETERS​

-Id​

The ID of the Maester 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​

If specified, retrieves only the Maester application with the specified Application (Client) ID.

Type: String
Parameter Sets: ByApplicationId
Aliases: ClientId

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

-Name​

If specified, retrieves only Maester applications with display names containing the specified text.

Type: String
Parameter Sets: Default
Aliases:

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

-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: 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://maester.dev/docs/commands/Get-MtMaesterApp