Udostępnij przez

Get-AzPolicyAssignment

Moduł:
Az.Resources Module

Pobiera przypisania zasad.

Składnia

Default (domyślnie) 

Get-AzPolicyAssignment
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Name 

Get-AzPolicyAssignment
    -Name <String>
    [-Scope <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

PolicyDefinitionId 

Get-AzPolicyAssignment
    -PolicyDefinitionId <String>
    [-Scope <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

IncludeDescendent 

Get-AzPolicyAssignment
    [-Scope <String>]
    [-IncludeDescendent]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Scope 

Get-AzPolicyAssignment
    -Scope <String>
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id 

Get-AzPolicyAssignment
    -Id <String>
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzPolicyAssignment pobiera wszystkie przypisania zasad lub określone przypisania. Zidentyfikuj przypisanie zasad, aby uzyskać według nazwy i zakresu lub identyfikatora.

Przykłady

Przykład 1. Pobieranie wszystkich przypisań zasad

Get-AzPolicyAssignment

To polecenie pobiera wszystkie przypisania zasad.

Przykład 2. Pobieranie określonego przypisania zasad

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

Pierwsze polecenie pobiera grupę zasobów o nazwie ResourceGroup11 przy użyciu polecenia cmdlet Get-AzResourceGroup i zapisuje ją w zmiennej $ResourceGroup. Drugie polecenie pobiera przypisanie zasad o nazwie PolicyAssignment07 dla zakresu, który identyfikuje właściwość ResourceId $ResourceGroup.

Przykład 3. Pobieranie wszystkich przypisań zasad przypisanych do grupy zarządzania

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope "/providers/Microsoft.Management/managementgroups/$mgId"

Pierwsze polecenie określa identyfikator grupy zarządzania do wykonywania zapytań. Drugie polecenie pobiera wszystkie przypisania zasad przypisane do grupy zarządzania o identyfikatorze "myManagementGroup".

Przykład 4. Pobieranie zakresu, identyfikatora definicji zestawu zasad i nazwy wyświetlanej wszystkich przypisań zasad sformatowanych jako lista

Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

To polecenie jest przydatne, gdy trzeba znaleźć przyjazną dla czytelnika właściwość DisplayName przypisania usługi Azure Policy.

Przykład 5: [Backcompat] Pobieranie zakresu, identyfikatora definicji zestawu zasad i nazwy wyświetlanej wszystkich przypisań zasad sformatowanych jako lista

Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

To polecenie jest przydatne, gdy trzeba znaleźć przyjazną dla czytelnika właściwość DisplayName przypisania usługi Azure Policy.

Parametry

-BackwardCompatible

Powoduje, że polecenie cmdlet zwraca artefakty przy użyciu starszego formatu umieszczania właściwości specyficznych dla zasad w obiekcie torby właściwości.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Właściwości parametru

Typ:PSObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Identyfikator przypisania zasad do pobrania. Użyj formatu "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator zasobu, PolicyAssignmentId

Zestawy parametrów

Id
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-IncludeDescendent

Powoduje, że lista zwracanych przypisań zasad zawiera wszystkie przypisania powiązane z danym zakresem, w tym z zakresów nadrzędnych i z zakresów malejących. Jeśli nie zostanie podana, uwzględniane są tylko przypisania w danym zakresie i powyżej niego.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

IncludeDescendent
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Name

Nazwa przypisania zasad do pobrania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:PolicyAssignmentName

Zestawy parametrów

Name
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-PolicyDefinitionId

Pobierz wszystkie przypisania zasad, które są przeznaczone dla podanej definicji zasad [w pełni kwalifikowany] identyfikator.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

PolicyDefinitionId
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Scope

Zakres przypisania zasad. Prawidłowe zakresy to: grupa zarządzania (format: "/providers/Microsoft.Management/managementGroups/{managementGroup}"), subskrypcja (format: "/subscriptions/{subscriptionId}"), grupa zasobów (format: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}", lub zasób (format: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}"

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Name
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
PolicyDefinitionId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
IncludeDescendent
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

SwitchParameter

String

Dane wyjściowe

IPolicyAssignment