Freigeben über


Get-AzPolicyExemption

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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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}.

Typ:String
Aliase:ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Der Name der abzurufenden Richtlinienausnahme.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PolicyAssignmentIdFilter

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Pre

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Scope

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

SwitchParameter

Ausgaben

PsPolicyExemption