Get-AzRoleDefinition
Visar en lista över alla Azure RBAC-roller som är tillgängliga för tilldelning.
Syntax
RoleDefinitionNameParameterSet (Standard)
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
Använd kommandot Get-AzRoleDefinition med ett visst rollnamn för att visa dess information. Om du vill granska enskilda åtgärder som en roll beviljar åtkomst till läser du rollens behörighetsegenskap. Varje behörighetspost innehåller egenskaper för Åtgärder, NotActions, DataActions, NotDataActions och eventuellt Egenskaper för Villkor och ConditionVersion. Roller med villkor för Attribute-Based Access Control (ABAC) har villkoret Och ConditionVersion inställt på lämplig behörighetspost.
Exempel
Exempel 1: Hämta en rolldefinition efter namn
Get-AzRoleDefinition -Name Reader
Hämtar rolldefinitionen Läsare med alla dess behörigheter.
Exempel 2: Lista alla RBAC-rolldefinitioner
Get-AzRoleDefinition
Visar en lista över alla Azure RBAC-rolldefinitioner som är tillgängliga i det aktuella omfånget.
Exempel 3: Åtkomståtgärder från en rolldefinition
$roleDef = Get-AzRoleDefinition -Name "Virtual Machine Contributor"
$roleDef.Permissions[0].Actions
Hämtar åtgärderna från den första behörighetsposten i en rolldefinition.
Exempel 4: Hämta alla behörigheter inklusive villkor
$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)"
}
}
Itererar genom alla behörighetsposter och visar åtgärder och eventuella ABAC-villkor.
Key Vault Data Access Administrator är en inbyggd roll som har ett verkligt ABAC-villkor på en av dess behörighetsposter, så if ($permission.Condition)-grenen utlöses faktiskt.
Parametrar
-Custom
Om det anges visas endast de anpassade skapade rollerna i katalogen.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
RoleDefinitionCustomParameterSet
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Parameteregenskaper
| Typ: | IAzureContextContainer |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Id
Rolldefinitions-ID.
Parameteregenskaper
| Typ: | Guid |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
RoleDefinitionIdParameterSet
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Name
Namn på rolldefinition. För t.ex. läsare, deltagare, virtuell datordeltagare.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
RoleDefinitionNameParameterSet
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Scope
Rolldefinitionsomfång.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-SkipClientSideScopeValidation
Om du anger det hoppar du över validering av klientsidans omfång.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
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.
Indata
String
Guid
SwitchParameter
Utdata
PSRoleDefinition
Kommentarer
Nyckelord: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment