Freigeben über


Remove-AzPolicyAssignment

Dieser Vorgang löscht eine Richtlinienzuweisung, wobei ihr Name und der Bereich angegeben wurde, in dem sie erstellt wurde. Der Gültigkeitsbereich einer Richtlinienzuweisung ist der Teil seiner ID vor "/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>]

Beschreibung

Dieser Vorgang löscht eine Richtlinienzuweisung, wobei ihr Name und der Bereich angegeben wurde, in dem sie erstellt wurde. Der Gültigkeitsbereich einer Richtlinienzuweisung ist der Teil seiner ID vor "/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

Beispiele

Beispiel 1: Entfernen der Richtlinienzuweisung nach Name und Bereich

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

Der erste Befehl ruft eine Ressourcengruppe namens ResourceGroup11 mithilfe des Cmdlets "Get-AzResourceGroup" ab. Der Befehl speichert dieses Objekt in der $ResourceGroup Variablen. Der zweite Befehl entfernt die Richtlinienzuweisung mit dem Namen "PolicyAssignment07", die auf Ressourcengruppenebene zugewiesen wurde. Die ResourceId-Eigenschaft von $ResourceGroup identifiziert die Ressourcengruppe.

Beispiel 2: Entfernen der Richtlinienzuweisung nach ID

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

Der erste Befehl ruft eine Ressourcengruppe namens ResourceGroup11 ab und speichert dieses Objekt dann in der $ResourceGroup Variablen. Der zweite Befehl ruft die Richtlinienzuweisung auf Ressourcengruppenebene ab und speichert sie dann in der variablen $PolicyAssignment. Die ResourceId-Eigenschaft von $ResourceGroup identifiziert die Ressourcengruppe. Der letzte Befehl entfernt die Richtlinienzuweisung, die die ResourceId-Eigenschaft von $PolicyAssignment identifiziert.

Beispiel 3: [Backcompat] Entfernen der Richtlinienzuweisung nach ID

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

Der erste Befehl ruft eine Ressourcengruppe namens ResourceGroup11 ab und speichert dieses Objekt dann in der $ResourceGroup Variablen. Der zweite Befehl ruft die Richtlinienzuweisung auf Ressourcengruppenebene ab und speichert sie dann in der variablen $PolicyAssignment. Die ResourceId-Eigenschaft von $ResourceGroup identifiziert die Ressourcengruppe. Der letzte Befehl entfernt die Richtlinienzuweisung, die die ResourceId-Eigenschaft von $PolicyAssignment identifiziert.

Parameter

-BackwardCompatible

Bewirkt, dass cmdlet Artefakte mithilfe von richtlinienspezifischen Eigenschaften im Legacyformat in einem Eigenschaftenbehälterobjekt zurückgibt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Wenn $true, überspringen Sie Bestätigungsaufforderungen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Die ID der zu löschenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

Typ:String
Aliase:ResourceId, PolicyAssignmentId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Typ:IPolicyIdentity
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Der Name der zu löschenden Richtlinienzuweisung.

Typ:String
Aliase:PolicyAssignmentName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt true zurück, wenn der Befehl erfolgreich ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Scope

Der Bereich der Richtlinienzuweisung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

IPolicyIdentity

String

Ausgaben

Boolean