Set-EntraDirectoryRoleDefinition

Set-EntraDirectoryRoleDefinition

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

ID で識別Microsoft Entra roleDefinition オブジェクトを更新します。 組み込みロールを更新することはできません。 この機能には、Microsoft Entra ID P1 または P2 ライセンスが必要です。

委任されたシナリオでは、サインインしているユーザーには、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールが必要です。 この操作に必要な最小ロールは次のとおりです。

• 特権ロール管理者

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -DisplayName 'UpdatedDisplayName'

次の使用例は、Microsoft Entra IDで指定されたロール定義を更新します。

• -UnifiedRoleDefinitionId パラメーターは roleDefinition オブジェクト ID を指定します。
• -DisplayName パラメーターは、ロール定義の表示名を指定します。

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -Description 'MYROLEUPDATE1S'

次の使用例は、Microsoft Entra IDで指定されたロール定義の説明を更新します。

• -UnifiedRoleDefinitionId パラメーターは roleDefinition オブジェクト ID を指定します。
• -Description パラメーターは、ロール定義の説明を指定します。

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -IsEnabled $true

次の使用例は、Microsoft Entra IDで指定されたロール定義の IsEnabled を更新します。

• -UnifiedRoleDefinitionId パラメーターは roleDefinition オブジェクト ID を指定します。
• -IsEnabled パラメーターは、ロール定義を有効にするかどうかを指定します。

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
$rolePermissions = New-object Microsoft.Open.MSGraph.Model.RolePermission
$rolePermissions.AllowedResourceActions = @("microsoft.directory/applications/standard/read")
$params = @{
    UnifiedRoleDefinitionId = $roleDefinition.Id
    Description             = 'Update'
    DisplayName             = 'Update'
    ResourceScopes          = '/'
    IsEnabled               = $false
    RolePermissions         = $rolePermissions
    TemplateId              = 'f2ef992c-3afb-46b9-b7cf-a126ee74c451'
    Version                 = 2
}
Set-EntraDirectoryRoleDefinition @params

次の使用例は、Microsoft Entra IDで指定されたロール定義の RolePermissions、TemplateId、TemplateId、ResourceScopes を更新します。

• -UnifiedRoleDefinitionId パラメーターは roleDefinition オブジェクト ID を指定します。
• -RolePermissions パラメーターは、ロール定義のアクセス許可を指定します。
• -IsEnabled パラメーターは、ロール定義を有効にするかどうかを指定します。
• -DisplayName パラメーターは、ロール定義の表示名を指定します。
• -Description パラメーターは、ロール定義の説明を指定します。
• -ResourceScopes パラメーターは、ロール定義のリソース スコープを指定します。
• -TemplateId パラメーターは、ロール定義のテンプレート ID を指定します。
• -Version パラメーターは、ロール定義のバージョンを指定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

Set-EntraRoleDefinition は Set-EntraDirectoryRoleDefintion の別名です。