Delen via


Get-AzPolicyExemption

Hiermee worden beleidsvrijstellingen ophaalt.

Syntaxis

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>]

Description

De cmdlet Get-AzPolicyExemption haalt alle beleidsuitzonderingen of bepaalde uitzonderingen op. Identificeer een beleidsuitzondering om op naam en bereik of op id te komen.

Voorbeelden

Voorbeeld 1 Alle beleidsvrijstellingen ophalen

Get-AzPolicyExemption

Met deze opdracht worden alle beleidsvrijstellingen in het huidige abonnement opgehaald. Als u alle uitzonderingen wilt weergeven die betrekking hebben op het opgegeven bereik, inclusief de uitzonderingen van bovenliggende bereiken en die van afstammingsbereiken, moet u de -IncludeDescendent parameter doorgeven.

Voorbeeld 2: Een specifieke beleidsvrijstelling ophalen

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

De eerste opdracht haalt een resourcegroep met de naam ResourceGroup11 op met behulp van de Cmdlet Get-AzResourceGroup en slaat deze op in de $ResourceGroup variabele. Met de tweede opdracht wordt de beleidsuitzondering met de naam PolicyExemption07 ophaalt voor het bereik dat de eigenschap ResourceId van $ResourceGroup identificeert.

Voorbeeld 3: Alle beleidsvrijstellingen ophalen die zijn gekoppeld aan een beleidstoewijzing

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

Met de eerste opdracht wordt een beleidstoewijzing met de naam PolicyAssignment07 opgehaald. Met de tweede opdracht worden alle beleidsvrijstellingen opgehaald die zijn toegewezen met de beleidstoewijzing.

Parameters

-ApiVersion

Wanneer deze is ingesteld, geeft u de versie van de resourceprovider-API aan die moet worden gebruikt. Als deze niet is opgegeven, wordt de API-versie automatisch bepaald als de meest recente beschikbare versie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

De volledig gekwalificeerde beleidsuitzonderings-id die moet worden opgehaald, inclusief het bereik, bijvoorbeeld /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

Type:String
Aliassen:ResourceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IncludeDescendent

Hiermee zorgt u ervoor dat de lijst met geretourneerde beleidsuitzonderingen alle uitzonderingen bevat die betrekking hebben op het opgegeven bereik, inclusief de uitzonderingen van bovenliggende bereiken en die van afstammende bereiken. Deze parameter werkt niet wanneer het aangevraagde bereik een beheergroepsbereik is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de beleidsvrijstelling die u wilt ophalen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PolicyAssignmentIdFilter

Hiermee beperkt u de lijst met geretourneerde beleidsuitzonderingen aan degenen die de beleidstoewijzing toewijzen die zijn geïdentificeerd door deze volledig gekwalificeerde id.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Pre

Wanneer deze is ingesteld, geeft u aan dat de cmdlet api-versies van de voorlopige versie moet gebruiken wanneer automatisch wordt bepaald welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Het bereik van de beleidsuitzondering om bijvoorbeeld /providers/managementGroups/{managementGroupName} op te halen, wordt standaard ingesteld op het huidige abonnement.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PsPolicyExemption