Edit

Share via

Get-EntraPermissionGrantPolicy

Module:
Microsoft.Entra Module v1.1

Gets a permission grant policy.

Syntax

GetQuery (Default) 

Get-EntraPermissionGrantPolicy

    [-Property <String[]>]
    [<CommonParameters>]

GetById 

Get-EntraPermissionGrantPolicy

    -Id <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

The Get-EntraPermissionGrantPolicy cmdlet gets a Microsoft Entra ID permission grant policy.

Examples

Example 1: Get all permission grant policies

Connect-Entra -Scopes 'Policy.Read.PermissionGrant'
Get-EntraPermissionGrantPolicy

DeletedDateTime Description
--------------- -----------
                Includes all application permissions (app roles), for all APIs, for any client application.
                Includes all chat resoruce-specific application permissions, for all APIs, for any client application.
                (Deprecated) Includes all team resource-specific application permissions, for all APIs, for any client application.

This command gets all the permission grant policies.

Example 2: Get a permission grant policy by ID

Connect-Entra -Scopes 'Policy.Read.PermissionGrant'
Get-EntraPermissionGrantPolicy -Id 'testtenant-sampleapp-permissions'

DeletedDateTime Description                               DisplayName            Id
--------------- -----------                               -----------            --
                Permissions for sample app in test tenant Sample app permissions testtenant-sampleapp-permissions

This command gets the specified permission grant policy.

  • Id parameter specifies the permission grant policy ID.

Parameters

-Id

Specifies the unique identifier of the permission grant policy.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

GetById
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-Property

Specifies properties to be returned.

Parameter properties

Type:

System.String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Select

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.