Dela via


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

Indata

String

SwitchParameter

Utdata

PsPolicyExemption