Get-AzPolicyDefinition
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
Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]