Get-AzPolicyExemption

Hiermee worden beleidsvrijstellingen ophaalt.

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

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

De naam van de beleidsvrijstelling die u wilt ophalen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PsPolicyExemption