Get-AzPolicyDefinition

Odwołanie

Moduł:: Az.Resources

Pobiera definicje zasad.

Składnia

Get-AzPolicyDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzPolicyDefinition pobiera kolekcję definicji zasad lub określoną definicję zasad zidentyfikowaną przez nazwę lub identyfikator.

Przykłady

Przykład 1. Pobieranie wszystkich definicji zasad

Get-AzPolicyDefinition

To polecenie pobiera wszystkie definicje zasad.

Przykład 2. Pobieranie definicji zasad z bieżącej subskrypcji według nazwy

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

To polecenie pobiera definicję zasad o nazwie VMPolicyDefinition z bieżącej subskrypcji domyślnej.

Przykład 3. Pobieranie definicji zasad z grupy zarządzania według nazwy

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'

To polecenie pobiera definicję zasad o nazwie VMPolicyDefinition z grupy zarządzania o nazwie Dept42.

Przykład 4. Pobieranie wszystkich wbudowanych definicji zasad z subskrypcji

Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin

To polecenie pobiera wszystkie wbudowane definicje zasad z subskrypcji o identyfikatorze 3bf44b72-c631-427a-b8c8-53e2595398ca.

Przykład 5. Pobieranie definicji zasad z danej kategorii

Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}

To polecenie pobiera wszystkie definicje zasad w kategorii Tagi.

Przykład 6. Pobieranie nazwy wyświetlanej, opisu, typu zasad i metadanych wszystkich definicji zasad sformatowanych jako lista

Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

To polecenie jest przydatne, gdy trzeba znaleźć przyjazną dla czytelnika właściwość DisplayName definicji usługi Azure Policy. Właściwość Metadata można przeanalizować, aby odnaleźć numer wersji definicji zasad i przypisanie kategorii.

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Builtin

Ogranicza listę wyników tylko do wbudowanych definicji zasad.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Custom

Ogranicza listę wyników tylko do niestandardowych definicji zasad.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Określa w pełni kwalifikowany identyfikator zasobu dla definicji zasad, którą pobiera to polecenie cmdlet.

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementGroupName

Nazwa grupy zarządzania definicji zasad do pobrania.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Określa nazwę definicji zasad, którą pobiera to polecenie cmdlet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Identyfikator subskrypcji definicji zasad do pobrania.

Type:	Nullable<T>[Guid]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Dane wejściowe

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Dane wyjściowe

PSObject