Get-AzPolicyAssignment

Moduł:

Az.Resources

Pobiera przypisania zasad.

Składnia

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

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

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

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

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

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 musisz 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 musisz 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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

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

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Id

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

Typ:	String
Aliasy:	ResourceId, PolicyAssignmentId
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Name

Nazwa przypisania zasad do pobrania.

Typ:	String
Aliasy:	PolicyAssignmentName
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-PolicyDefinitionId

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

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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}"

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

SwitchParameter

String

Dane wyjściowe

IPolicyAssignment