Get-AzPolicyDefinition

Referenz

Modul:: Az.Resources

Ruft Richtliniendefinitionen ab.

Syntax

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>]

Beschreibung

Das Cmdlet "Get-AzPolicyDefinition " ruft eine Sammlung von Richtliniendefinitionen oder einer bestimmten Richtliniendefinition ab, die durch den Namen oder die ID identifiziert wird.

Beispiele

Beispiel 1: Abrufen aller Richtliniendefinitionen

Get-AzPolicyDefinition

Dieser Befehl ruft alle Richtliniendefinitionen ab.

Beispiel 2: Abrufen der Richtliniendefinition aus dem aktuellen Abonnement anhand des Namens

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Dieser Befehl ruft die Richtliniendefinition mit dem Namen "VMPolicyDefinition" aus dem aktuellen Standardabonnement ab.

Beispiel 3: Abrufen der Richtliniendefinition aus der Verwaltungsgruppe anhand des Namens

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

Dieser Befehl ruft die Richtliniendefinition mit dem Namen "VMPolicyDefinition" aus der Verwaltungsgruppe "Dept42" ab.

Beispiel 4: Abrufen aller integrierten Richtliniendefinitionen aus dem Abonnement

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

Dieser Befehl ruft alle integrierten Richtliniendefinitionen aus dem Abonnement mit der ID 3bf44b72-c631-427a-b8c8-53e2595398ca ab.

Beispiel 5: Abrufen von Richtliniendefinitionen aus einer bestimmten Kategorie

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

Dieser Befehl ruft alle Richtliniendefinitionen in den Kategorietags ab.

Beispiel 6: Abrufen des Anzeigenamens, der Beschreibung, des Richtlinientyps und der Metadaten aller Als Liste formatierten Richtliniendefinitionen

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

Dieser Befehl ist nützlich, wenn Sie die anzeigefreundliche DisplayName-Eigenschaft einer Azure-Richtliniendefinition finden müssen. Sie können die Metadata-Eigenschaft analysieren, um die Versionsnummer und Kategoriezuweisung der Richtliniendefinition zu ermitteln.

Parameter

-ApiVersion

Gibt die version der zu verwendenden Ressourcenanbieter-API an. Wenn Sie keine Version angeben, verwendet dieses Cmdlet die neueste verfügbare Version.

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

-Builtin

Liste der Ergebnisse auf integrierte Richtliniendefinitionen beschränkt.

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

-Custom

Liste der Ergebnisse auf benutzerdefinierte Richtliniendefinitionen beschränkt.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-Id

Gibt die vollqualifizierte Ressourcen-ID für die Richtliniendefinition an, die dieses Cmdlet abruft.

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

-ManagementGroupName

Der Name der Verwaltungsgruppe der abzurufenden Richtliniendefinitionen.

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

-Name

Gibt den Namen der Richtliniendefinition an, die dieses Cmdlet abruft.

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

-Pre

Gibt an, dass dieses Cmdlet vorab veröffentlichte API-Versionen berücksichtigt, wenn es automatisch bestimmt, welche Version verwendet werden soll.

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

-SubscriptionId

Die Abonnement-ID der abzurufenden Richtliniendefinitionen.

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

Eingaben

String

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

Ausgaben

PSObject