Delen via


Set-AzRoleDefinition

Hiermee wijzigt u een aangepaste rol in Azure RBAC. Geef de gewijzigde roldefinitie op als een JSON-bestand of als een PSRoleDefinition. Gebruik eerst de opdracht Get-AzRoleDefinition om de aangepaste rol op te halen die u wilt wijzigen. Wijzig vervolgens de eigenschappen die u wilt wijzigen. Sla ten slotte de roldefinitie op met behulp van deze opdracht.

Syntaxis

Set-AzRoleDefinition
   -InputFile <String>
   [-SkipClientSideScopeValidation]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzRoleDefinition
   -Role <PSRoleDefinition>
   [-SkipClientSideScopeValidation]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De cmdlet Set-AzRoleDefinition werkt een bestaande aangepaste rol bij in Op rollen gebaseerd toegangsbeheer van Azure. Geef de bijgewerkte roldefinitie op als invoer voor de opdracht als een JSON-bestand of een PSRoleDefinition-object. De roldefinitie voor de bijgewerkte aangepaste rol MOET de id en alle andere vereiste eigenschappen van de rol bevatten, zelfs als ze niet worden bijgewerkt: DisplayName, Beschrijving, Acties, AssignableScopes. NotActions, DataActions, NotDataActions zijn optioneel.

Voorbeelden

Voorbeeld 1: Bijwerken met PSRoleDefinitionObject

$roleDef = Get-AzRoleDefinition "Contoso On-Call"
$roleDef.Actions.Add("Microsoft.ClassicCompute/virtualmachines/start/action")
$roleDef.Description = "Can monitor all resources and start and restart virtual machines"
$roleDef.AssignableScopes = @("/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
Set-AzRoleDefinition -Role $roleDef

Voorbeeld 2: Maken met behulp van JSON-bestand

Set-AzRoleDefinition -InputFile C:\Temp\roleDefinition.json
<#
Following is a sample updated role definition json for Set-AzRoleDefinition:
{
        "Id": "52a6cc13-ff92-47a8-a39b-2a8205c3087e",
        "Name": "Updated Role",
        "Description": "Can monitor all resources and start and restart virtual machines",
        "Actions":
        [
            "*/read",
            "Microsoft.ClassicCompute/virtualmachines/restart/action",
            "Microsoft.ClassicCompute/virtualmachines/start/action"
        ],
        "NotActions":
        [
            "*/write"
        ],
        "DataActions":
        [
            "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read"
        ],
        "NotDataActions":
        [
            "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write"
        ],
        "AssignableScopes": ["/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
}
#>

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputFile

Bestandsnaam met één json-roldefinitie die moet worden bijgewerkt. Neem alleen de eigenschappen op die moeten worden bijgewerkt in de JSON. Id-eigenschap is vereist.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Role

Roldefinitieobject dat moet worden bijgewerkt

Type:PSRoleDefinition
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SkipClientSideScopeValidation

Als u dit hebt opgegeven, slaat u de validatie van het bereik aan de clientzijde over.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSRoleDefinition

Uitvoerwaarden

PSRoleDefinition

Notities

Trefwoorden: azure, azurerm, arm, resource, beheer, manager, resource, groep, sjabloon, implementatie