Freigeben über

Remove-AzPolicyAssignment

Modul:
Az.Resources Module

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

Name (Standard) 

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

Id 

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

InputObject 

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.Id -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 -BackwardCompatible
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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRMContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Wenn $true, überspringen Sie Bestätigungsaufforderungen

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:RessourcenID, PolicyAssignmentId

Parametersätze

Id
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-InputObject

Identitätsparameter Zu erstellen finden Sie im Abschnitt NOTES für INPUTOBJECT-Eigenschaften, und erstellen Sie eine Hashtabelle.

Parametereigenschaften

Typ:IPolicyIdentity
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

InputObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Der Name der zu löschenden Richtlinienzuweisung.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PolicyAssignmentName

Parametersätze

Name
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PassThru

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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}'

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Name
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

IPolicyIdentity

String

Ausgaben

Boolean