Get-AzureADServiceAppRoleAssignment.md

external help file	Module Name	online version	schema
Microsoft.Open.AzureAD16.Graph.PowerShell.dll-Help.xml	AzureAD		2.0.0

Get-AzureADServiceAppRoleAssignment

SYNOPSIS

Gets a service principal application role assignment.

SYNTAX

Get-AzureADServiceAppRoleAssignment -ObjectId <String> [-All <Boolean>] [-Top <Int32>] [<CommonParameters>]

DESCRIPTION

The Get-AzureADServiceAppRoleAssignment cmdlet gets a role assignment for a service principal application in Azure Active Directory (AD).

EXAMPLES

Example 1: Retrieve the application role assignments for a service principal

PS C:\> $ServicePrincipalId = (Get-AzureADServicePrincipal -Top 1).ObjectId
PS C:\> Get-AzureADServiceAppRoleAssignment -ObjectId $ServicePrincipalId

The first command gets the ID of a service principal by using the Get-AzureADServicePrincipal (./Get-AzureADServicePrincipal.md)cmdlet. The command stores the ID in the $ServicePrincipalId variable.

The second command gets the application role assignments for the service principal in identified by $ServicePrincipalId.

PARAMETERS

-All

If true, return all application role assignments. If false, return the number of objects specified by the Top parameter

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ObjectId

Specifies the ID of a service principal in Azure AD.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Top

The maximum number of records to return.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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.

NOTES

See the migration guide for Get-AzureADServiceAppRoleAssignment to the Microsoft Graph PowerShell.

INPUTS

OUTPUTS

RELATED LINKS

Get-AzureADServicePrincipal

New-AzureADServiceAppRoleAssignment

Remove-AzureADServiceAppRoleAssignment