Skip to main content

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

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