Get-AzRoleDefinition

Een lijst met alle Azure RBAC-rollen die beschikbaar zijn voor toewijzing.

Syntax

RoleDefinitionNameParameterSet (Standaard)

Get-AzRoleDefinition
    [[-Name] <String>]
    [-Scope <String>]
    [-SkipClientSideScopeValidation]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RoleDefinitionIdParameterSet

Get-AzRoleDefinition
    -Id <Guid>
    [-Scope <String>]
    [-SkipClientSideScopeValidation]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RoleDefinitionCustomParameterSet

Get-AzRoleDefinition
    [-Scope <String>]
    [-Custom]
    [-SkipClientSideScopeValidation]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Gebruik de opdracht Get-AzRoleDefinition met een bepaalde rolnaam om de details ervan weer te geven. Als u afzonderlijke bewerkingen wilt controleren waartoe een rol toegang verleent, controleert u de eigenschap Machtigingen van de rol. Elke machtigingsvermelding bevat de eigenschappen Actions, NotActions, DataActions, NotDataActions en optioneel Condition en ConditionVersion. Rollen met Attribute-Based Access Control voorwaarden (ABAC) hebben de Voorwaarde en ConditionVersion ingesteld op de juiste machtigingsvermelding.

Voorbeelden

Voorbeeld 1: Een roldefinitie ophalen op naam

Get-AzRoleDefinition -Name Reader

Haalt de roldefinitie Lezer op met alle bijbehorende machtigingen.

Voorbeeld 2: alle RBAC-roldefinities weergeven

Get-AzRoleDefinition

Een lijst met alle Azure RBAC-roldefinities die beschikbaar zijn in het huidige bereik.

Voorbeeld 3: Toegangsacties van een roldefinitie

$roleDef = Get-AzRoleDefinition -Name "Virtual Machine Contributor"
$roleDef.Permissions[0].Actions

Haalt de acties op van de eerste machtigingsvermelding van een roldefinitie.

Voorbeeld 4: Alle machtigingen ophalen, inclusief voorwaarden

$roleDef = Get-AzRoleDefinition -Name "Key Vault Data Access Administrator"
foreach ($permission in $roleDef.Permissions) {
    Write-Host "Actions: $($permission.Actions -join ', ')"
    Write-Host "DataActions: $($permission.DataActions -join ', ')"
    if ($permission.Condition) {
        Write-Host "Condition: $($permission.Condition)"
        Write-Host "ConditionVersion: $($permission.ConditionVersion)"
    }
}

Doorloopt alle machtigingsvermeldingen en geeft acties en eventuele ABAC-voorwaarden weer. Key Vault Data Access Administrator is een ingebouwde rol die een echte ABAC-voorwaarde heeft op een van de machtigingsvermeldingen, zodat de if ($permission.Condition) vertakking daadwerkelijk wordt geactiveerd.

Parameters

-Custom

Als dit is opgegeven, worden alleen de aangepaste gemaakte rollen in de map weergegeven.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RoleDefinitionCustomParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

Roldefinitie-id.

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RoleDefinitionIdParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Naam van roldefinitie. Voor bijvoorbeeld Lezer, Inzender, Inzender voor virtuele machines.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RoleDefinitionNameParameterSet
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Scope

Bereik van roldefinitie.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SkipClientSideScopeValidation

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Guid

SwitchParameter

Uitvoerwaarden

PSRoleDefinition

Notities

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