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

Uppdaterar ett Microsoft Entra roleDefinition-objekt som identifieras av ID. Du kan inte uppdatera inbyggda roller. Den här funktionen kräver en Microsoft Entra ID P1- eller P2-licens.

I delegerade scenarier måste den inloggade användaren ha antingen en Microsoft Entra roll som stöds eller en anpassad roll med nödvändiga behörigheter. De minsta roller som krävs för den här åtgärden är:

• Privilegierad rolladministratör

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

I det här exemplet uppdateras den angivna rolldefinitionen i Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter anger roleDefinition-objekt-ID.
• -DisplayName parameter anger visningsnamnet för rolldefinitionen.

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

I det här exemplet uppdateras beskrivningen av den angivna rolldefinitionen i Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter anger roleDefinition-objekt-ID.
• -Description parameter anger beskrivningen för rolldefinitionen.

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

I det här exemplet uppdateras IsEnabled för den angivna rolldefinitionen i Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter anger roleDefinition-objekt-ID.
• -IsEnabled parameter anger om rolldefinitionen är aktiverad.

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

I det här exemplet uppdateras RolePermissions, TemplateId, TemplateId, ResourceScopes för angiven rolldefinition i Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter anger roleDefinition-objekt-ID.
• -RolePermissions parameter anger behörigheterna för rolldefinitionen.
• -IsEnabled parameter anger om rolldefinitionen är aktiverad.
• -DisplayName parameter anger visningsnamnet för rolldefinitionen.
• -Description parameter anger beskrivningen för rolldefinitionen.
• -ResourceScopes parametern anger resursomfattningarna för rolldefinitionen.
• -TemplateId parameter anger mall-ID för rolldefinitionen.
• -Version parameter anger versionen för rolldefinitionen.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Set-EntraRoleDefinition är ett alias för Set-EntraDirectoryRoleDefintion.