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 |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | 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 |
Alias: | ResourceId |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Name
Namnet på principundantaget som ska hämtas.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |