Dela via


Get-AzPolicyExemption

Hämtar principundantag.

Syntax

Get-AzPolicyExemption
   [-Name <String>]
   [-Scope <String>]
   [-PolicyAssignmentIdFilter <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-PolicyAssignmentIdFilter <String>]
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

Cmdleten Get-AzPolicyExemption hämtar en samling principundantag eller ett specifikt principundantag som identifieras med namn eller 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

-BackwardCompatible

Gör att cmdleten returnerar artefakter med äldre format som placerar principspecifika egenskaper i ett egenskapspåseobjekt.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Det fullständigt kvalificerade resurs-ID:t för undantaget.

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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på principundantaget.

Typ:String
Alias:PolicyExemptionName
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PolicyAssignmentIdFilter

ID-filtret för principtilldelning.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Scope

Omfånget för principundantaget. Giltiga omfång är: hanteringsgrupp (format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), prenumeration (format: '/subscriptions/{subscriptionId}'), resursgrupp (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', eller resurs (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

SwitchParameter

String

Utdata

IPolicyExemption