Udostępnij za pośrednictwem

Get-AzPolicyAssignment

  • Odwołanie
Moduł:
Az.Resources

Pobiera przypisania zasad.

Składnia

Get-AzPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<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 -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

-ApiVersion

Określa wersję interfejsu API dostawcy zasobów do użycia. Jeśli nie określisz wersji, to polecenie cmdlet używa najnowszej dostępnej wersji.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

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

-Id

Określa w pełni kwalifikowany identyfikator zasobu dla przypisania zasad, które otrzymuje to polecenie cmdlet.

Typ:String
Aliasy:ResourceId
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.

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

-Name

Określa nazwę przypisania zasad, które otrzymuje to polecenie cmdlet.

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

-PolicyDefinitionId

Określa identyfikator definicji zasad przypisań zasad pobieranych przez to polecenie cmdlet.

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

-Pre

Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.

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

-Scope

Określa zakres, w którym zasady są stosowane do przypisania, które otrzymuje to polecenie cmdlet.

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

Dane wejściowe

String

SwitchParameter

Dane wyjściowe

PsPolicyAssignment