Get-AzPolicyExemption

Referenz

Modul:: Az.Resources

Ruft Richtlinienausnahmen ab.

Syntax

Get-AzPolicyExemption
   [-Name <String>]
   [-Scope <String>]
   [-PolicyAssignmentIdFilter <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyExemption
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

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

Beschreibung

Das Cmdlet "Get-AzPolicyExemption " ruft alle Richtlinienausnahmen oder bestimmte Ausnahmen ab. Identifizieren Sie eine Richtlinienausnahme, die nach Name und Bereich oder nach ID abgerufen werden soll.

Beispiele

Beispiel 1 Abrufen aller Richtlinienausnahmen

Get-AzPolicyExemption

Dieser Befehl ruft alle Richtlinienausnahmen im aktuellen Abonnement ab. Wenn Sie alle Ausnahmen im Zusammenhang mit dem angegebenen Bereich auflisten müssen, einschließlich der ausnahmen von vorgängerbezogenen Bereichen und denen aus untergeordneten Bereichen, müssen Sie den -IncludeDescendent Parameter übergeben.

Beispiel 2: Abrufen einer bestimmten Richtlinienausnahme

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId

Der erste Befehl ruft eine Ressourcengruppe namens ResourceGroup11 mithilfe des Cmdlets "Get-AzResourceGroup" ab und speichert sie in der variablen $ResourceGroup. Der zweite Befehl ruft die Richtlinienausnahme mit dem Namen PolicyExemption07 für den Bereich ab, den die ResourceId-Eigenschaft von $ResourceGroup identifiziert.

Beispiel 3: Abrufen aller Richtlinienausnahmen, die einer Richtlinienzuweisung zugeordnet sind

$Assignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07'
Get-AzPolicyExemption -PolicyAssignmentIdFilter $Assignment.ResourceId

Der erste Befehl ruft eine Richtlinienzuweisung namens "PolicyAssignment07" ab. Der zweite Befehl ruft alle Richtlinienausnahmen ab, die der Richtlinienzuweisung zugewiesen sind.

Parameter

-ApiVersion

Wenn festgelegt, gibt die Version der zu verwendenden Ressourcenanbieter-API an. Wenn nicht angegeben, wird die API-Version automatisch als neueste verfügbare Version bestimmt.

Type:	String
Position:	Named
Default value:	None
Required:	False
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

Die vollqualifizierte Richtlinienausnahme-ID, die abgerufen werden soll, einschließlich des Bereichs, z. B. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

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

-IncludeDescendent

Bewirkt, dass die Liste der zurückgegebenen Richtlinienausnahmen alle Ausnahmen im Zusammenhang mit dem angegebenen Bereich enthält, einschließlich derjenigen aus vorgängern Bereichen und denen von absteigenden Bereichen. Dieser Parameter funktioniert nicht, wenn der angeforderte Bereich ein Verwaltungsgruppenbereich ist.

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

-Name

Der Name der abzurufenden Richtlinienausnahme.

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

-PolicyAssignmentIdFilter

Beschränkt die Liste der zurückgegebenen Richtlinienausnahmen auf diejenigen, die die von dieser vollqualifizierten ID identifizierte Richtlinienzuweisung zuweisen.

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

-Pre

Wenn festgelegt, gibt an, dass das Cmdlet Vorabversionen von API-Versionen verwenden soll, wenn automatisch bestimmt wird, welche Version verwendet werden soll.

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

-Scope

Der Umfang der Richtlinienausnahme, die abgerufen werden soll, z. B. "/providers/managementGroups/{managementGroupName}", ist standardmäßig auf das aktuelle Abonnement festgelegt.

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

Eingaben

String

SwitchParameter

Ausgaben

PsPolicyExemption