New-EntraPermissionGrantPolicy

Creates a permission grant policy.

Syntax

New-EntraPermissionGrantPolicy
   -Id <String>
   [-DisplayName <String>]
   [-Description <String>]
   [<CommonParameters>]

Description

The New-EntraPermissionGrantPolicy cmdlet creates a Microsoft Entra ID permission grant policy.

Examples

Example 1: Create a permission grant policy

Connect-Entra -Scopes 'Policy.ReadWrite.PermissionGrant'
$params = @{
    Id = 'my_new_permission_grant_policy_id'
    DisplayName = 'MyNewPermissionGrantPolicy'
    Description = 'My new permission grant policy'
}

New-EntraPermissionGrantPolicy @params

DeletedDateTime Description                    DisplayName                Id
--------------- -----------                    -----------                --
                My new permission grant policy MyNewPermissionGrantPolicy my_new_permission_grant_policy_id

This example creates new permission grant policy in Microsoft Entra ID.

  • -Id parameter specifies the unique identifier of the permission grant policy.
  • -DisplayName parameter specifies the display name for the permission grant policy.
  • -Description parameter specifies the description for the permission grant policy.

Parameters

-Description

Specifies the description for the permission grant policy.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifies the display name for the permission grant policy.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specifies the unique identifier of the permission grant policy.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False