Get-AzPolicyExemption
Hämtar principundantag.
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
Cmdleten Get-AzPolicyExemption hämtar alla principundantag eller särskilda undantag. Identifiera ett principundantag för att hämta efter namn och omfång eller efter ID.
Exempel
Exempel 1 Hämta alla principundantag
Get-AzPolicyExemption
Det här kommandot hämtar alla principundantag i den aktuella prenumerationen. Om du behöver lista alla undantag som är relaterade till det angivna omfånget, inklusive de från överordnade omfång och de från underordnade omfång, måste du skicka parametern -IncludeDescendent
.
Exempel 2: Hämta ett specifikt principundantag
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 med hjälp av cmdleten Get-AzResourceGroup och lagrar den i variabeln $ResourceGroup. Det andra kommandot hämtar principundantaget med namnet PolicyExemption07 för det omfång som ResourceId-egenskapen för $ResourceGroup identifierar.
Exempel 3: Hämta alla principundantag som är associerade med en principtilldelning
$Assignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07'
Get-AzPolicyExemption -PolicyAssignmentIdFilter $Assignment.ResourceId
Det första kommandot hämtar en principtilldelning med namnet PolicyAssignment07. Det andra kommandot hämtar alla principundantag som tilldelas med principtilldelningen.
Parametrar
-ApiVersion
När värdet anges anger du vilken version av resursprovider-API:et som ska användas. Om den inte anges bestäms API-versionen automatiskt som den senaste tillgängliga.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Det fullständigt kvalificerade principundantags-ID som ska hämtas, inklusive omfånget, t.ex. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.
Typ: | String |
Aliases: | ResourceId |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IncludeDescendent
Gör att listan över returnerade principundantag inkluderar alla undantag som är relaterade till det angivna omfånget, inklusive de från överordnade omfång och de från underordnade omfång. Den här parametern fungerar inte när det begärda omfånget är ett hanteringsgruppsomfång.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Namnet på principundantaget som ska hämtas.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyAssignmentIdFilter
Begränsar listan över returnerade principundantag till dem som tilldelar den principtilldelning som identifieras av det här fullständigt kvalificerade ID:t.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pre
När den anges anger att cmdleten ska använda förhandsversioner av API-versioner när du automatiskt avgör vilken version som ska användas.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Omfånget för principundantaget som ska hämtas, t.ex. /providers/managementGroups/{managementGroupName}, är standard för den aktuella prenumerationen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |