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 |