Sdílet prostřednictvím

Set-AzRoleDefinition

  • Reference
Modul:
Az.Resources

Upraví vlastní roli v Azure RBAC. Zadejte upravenou definici role buď jako soubor JSON, nebo jako PSRoleDefinition. Nejprve pomocí příkazu Get-AzRoleDefinition načtěte vlastní roli, kterou chcete upravit. Potom upravte vlastnosti, které chcete změnit. Nakonec pomocí tohoto příkazu uložte definici role.

Syntaxe

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

Description

Rutina Set-AzRoleDefinition aktualizuje existující vlastní roli v Azure Role-Based Řízení přístupu. Zadejte aktualizovanou definici role jako vstup příkazu jako soubor JSON nebo objekt PSRoleDefinition. Definice role aktualizované vlastní role musí obsahovat ID a všechny ostatní požadované vlastnosti role, i když nejsou aktualizovány: DisplayName, Description, Actions, AssignableScopes. NotActions, DataActions, NotDataActions jsou volitelné.

Příklady

Příklad 1: Aktualizace pomocí 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

Příklad 2: Vytvoření pomocí souboru JSON

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"]
}
#>

Parametry

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputFile

Název souboru obsahující jednu definici role JSON, která se má aktualizovat. Zahrnout pouze vlastnosti, které se mají aktualizovat ve formátu JSON. Vlastnost ID je povinná.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Role

Objekt definice role, který se má aktualizovat

Typ:PSRoleDefinition
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SkipClientSideScopeValidation

Pokud je zadáno, přeskočte ověření oboru na straně klienta.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSRoleDefinition

Výstupy

PSRoleDefinition

Poznámky

Klíčová slova: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment