Dela via


Remove-AzPolicyAssignment

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

Syntax

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

Description

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

Exempel

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

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId -Force

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 principtilldelningen med namnet PolicyAssignment07 som tilldelades på resursgruppsnivå. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen.

Exempel 2: Ta bort principtilldelning efter ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false

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

Exempel 3: [Backcompat] Ta bort principtilldelning efter ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false -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 principtilldelningen på resursgruppsnivå och lagrar den sedan i variabeln $PolicyAssignment. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen. Det sista kommandot tar bort den principtilldelning som egenskapen ResourceId för $PolicyAssignment 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
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
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

-Force

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

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

-Id

ID:t för principtilldelningen som ska tas bort. Använd formatet {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

Typ:String
Alias:ResourceId, PolicyAssignmentId
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på den principtilldelning som ska tas bort.

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

-PassThru

Returnerar sant när kommandot lyckas

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

-Scope

Omfånget för principtilldelningen. 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

-WhatIf

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

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

Indata

IPolicyIdentity

String

Utdata

Boolean