Freigeben über


Get-AzPolicyExemption

Ruft Richtlinienausnahmen ab.

Syntax

Get-AzPolicyExemption
   [-Name <String>]
   [-Scope <String>]
   [-PolicyAssignmentIdFilter <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-PolicyAssignmentIdFilter <String>]
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzPolicyExemption " ruft eine Sammlung von Richtlinienausnahmen oder eine bestimmte Richtlinienausnahme ab, die anhand des Namens oder der ID identifiziert wird.

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

-BackwardCompatible

Bewirkt, dass cmdlet Artefakte mithilfe von richtlinienspezifischen Eigenschaften im Legacyformat in einem Eigenschaftenbehälterobjekt zurückgibt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Die vollqualifizierte Ressourcen-ID der Ausnahme.

Typ:String
Aliases:ResourceId
Position:Named
Standardwert:None
Erforderlich: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Der Name der Richtlinienausnahme.

Typ:String
Aliases:PolicyExemptionName
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-PolicyAssignmentIdFilter

Der Filter für die Richtlinienzuweisungs-ID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Der Anwendungsbereich der Richtlinienfreistellung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

SwitchParameter

String

Ausgaben

IPolicyExemption