Dela via


Remove-AzPolicyExemption

Den här åtgärden tar bort ett principundantag med namnet och det omfång som det skapades i. Omfånget för ett principundantag är den del av dess ID som föregår "/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}".

Syntax

Remove-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicyExemption
      -Id <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicyExemption
      -InputObject <IPolicyIdentity>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Den här åtgärden tar bort ett principundantag med namnet och det omfång som det skapades i. Omfånget för ett principundantag är den del av dess ID som föregår "/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}".

Exempel

Exempel 1: Ta bort principundantag efter namn och omfång

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId -Confirm

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 med hjälp av cmdleten Get-AzResourceGroup. Kommandot lagrar objektet i variabeln $ResourceGroup. Det andra kommandot tar bort principundantaget med namnet PolicyExemption07 som tilldelades på resursgruppsnivå. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen.

Exempel 2: Ta bort principundantag efter ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyExemption -Id $PolicyExemption.ResourceId -Confirm

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 och lagrar sedan objektet i variabeln $ResourceGroup. Det andra kommandot hämtar principundantaget på resursgruppsnivå och lagrar det sedan i variabeln $PolicyExemption. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen. Det sista kommandot tar bort det principundantag som egenskapen ResourceId för $PolicyExemption identifierar.

Exempel 3: [Backcompat] Ta bort principundantag efter ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyExemption -Id $PolicyExemption.ResourceId -Force -BackwardCompatible
True

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 och lagrar sedan objektet i variabeln $ResourceGroup. Det andra kommandot hämtar principundantaget på resursgruppsnivå och lagrar det sedan i variabeln $PolicyExemption. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen. Det sista kommandot tar bort det principundantag som egenskapen ResourceId för $PolicyExemption identifierar.

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
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:AzureRMContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

När $true hoppar du över bekräftelsemeddelanden

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

ID:t för principundantaget som ska tas bort. Använd formatet {scope}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

Typ:String
Aliases:ResourceId, PolicyExemptionId
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Identitetsparameter För att skapa, se AVSNITTET ANTECKNINGAR för INPUTOBJECT-egenskaper och skapa en hash-tabell.

Typ:IPolicyIdentity
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Namnet på principundantaget som ska tas bort.

Typ:String
Aliases:PolicyExemptionName
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Returnerar sant när kommandot lyckas

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

IPolicyIdentity

String

Utdata

Boolean