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 |