New-AzureADMSRoleDefinition

リファレンス

モジュール:: AzureAD

Azure AD ロール定義を作成します。

構文

New-AzureADMSRoleDefinition
   [-Description <String>]
   -DisplayName <String>
   [-ResourceScopes <System.Collections.Generic.List`1[System.String]>]
   -IsEnabled <Boolean>
   -RolePermissions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RolePermission]>
   [-TemplateId <String>]
   [-Version <String>]
   [<CommonParameters>]

説明

New-AzureADMSRoleDefinition コマンドレットは、Azure Active Directory (Azure AD) ロール定義を作成します。

例

例 1

PS C:\>
$allowedResourceAction = @()
$allowedResourceAction += @("microsoft.directory/applications/create")
$rolePermission = @{'allowedResourceActions' = $allowedResourceAction}
$rolePermissions = @()
$rolePermissions += $rolePermission

$resourceScopes = @()
$resourceScopes += '/'

New-AzureADMSRoleDefinition -RolePermissions $rolePermissions -IsEnabled $true -DisplayName 'MyRoleDefinition' -ResourceScopes $resourceScopes

Id              : c466024e-f757-4409-a897-d780916814b1
OdataType       :
Description     :
DisplayName     : fgdf
IsBuiltIn       : False
ResourceScopes  : {/}
IsEnabled       : True
RolePermissions : {class RolePermission {
                  AllowedResourceActions:
                  microsoft.directory/applications/create
                    Condition:
                  }
                  }
TemplateId      : 4dd5aa9c-cf4d-4895-a993-740d342802b9
Version         :

このコマンドにより、Azure AD に新しいロール定義が作成されます。

パラメーター

-Description

ロール定義の説明を指定します。

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

-DisplayName

ロール定義の表示名を指定します。

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

-IsEnabled

ロール定義を有効にするかどうかを指定します。

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

-ResourceScopes

ロール定義のリソーススコープを指定します。

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RolePermissions

ロール定義のアクセス許可を指定します。

Type:	List<T>[Microsoft.Open.MSGraph.Model.RolePermission]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateId

ロール定義のテンプレート ID を指定します。

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

-Version

ロール定義のバージョンを指定します。

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

出力

Microsoft.Open.MSGraph.Model.DirectoryRoleDefinition

メモ

Microsoft Graph PowerShell への New-AzureADMSRoleDefinition の移行ガイドを参照してください。