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>]

Atualiza um objeto Microsoft Entra roleDefinition identificado por ID. Não podes atualizar os papéis integrados. Esta funcionalidade requer uma licença Microsoft Entra ID P1 ou P2.

Em cenários delegados, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um papel personalizado com as permissões necessárias. Os papéis mínimos exigidos para esta operação são:

• Administrador de Função Privilegiada

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

Este exemplo atualiza a definição de função especificada no Microsoft Entra ID.

• -UnifiedRoleDefinitionId o parâmetro especifica o ID do objeto roleDefinition.
• -DisplayName O parâmetro especifica o nome de exibição para a definição do papel.

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

Este exemplo atualiza a Descrição da definição de função especificada no Microsoft Entra ID.

• -UnifiedRoleDefinitionId o parâmetro especifica o ID do objeto roleDefinition.
• -Description O parâmetro especifica a descrição para a definição do papel.

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

Este exemplo atualiza o IsEnabled da definição de função especificada no Microsoft Entra ID.

• -UnifiedRoleDefinitionId o parâmetro especifica o ID do objeto roleDefinition.
• -IsEnabled O parâmetro especifica se a definição do papel está ativada.

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

Este exemplo atualiza os RolePermissions, TemplateId, TemplateId, ResourceScopes da definição de função especificada no Microsoft Entra ID.

• -UnifiedRoleDefinitionId o parâmetro especifica o ID do objeto roleDefinition.
• -RolePermissions parâmetro especifica as permissões para a definição do papel.
• -IsEnabled O parâmetro especifica se a definição do papel está ativada.
• -DisplayName O parâmetro especifica o nome de exibição para a definição do papel.
• -Description O parâmetro especifica a descrição para a definição do papel.
• -ResourceScopes O parâmetro especifica os escopos de recursos para a definição do papel.
• -TemplateId o parâmetro especifica o ID do modelo para a definição do papel.
• -Version O parâmetro especifica a versão para a definição do papel.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Set-EntraRoleDefinition é um alias para Set-EntraDirectoryRoleDefintion.