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 egenskapen ResourceId 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. Om detta inte anges inkluderas endast undantag vid och över det angivna omfånget.

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