Freigeben über

Remove-AzPolicySetDefinition

  • Referenz
Modul:
Az.Resources

Dieser Vorgang löscht die Richtliniendefinition im angegebenen Abonnement mit dem angegebenen Namen.

Syntax

Remove-AzPolicySetDefinition
      -Name <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicySetDefinition
      -Name <String>
      -ManagementGroupName <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicySetDefinition
      -Name <String>
      -SubscriptionId <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicySetDefinition
      -Id <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicySetDefinition
      -InputObject <IPolicyIdentity>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Dieser Vorgang löscht die Richtliniendefinition im angegebenen Abonnement mit dem angegebenen Namen.

Beispiele

Beispiel 1: Entfernen der Richtliniensatzdefinition nach Ressourcen-ID

$PolicySetDefinition = Get-AzPolicySetDefinition -ResourceId '/subscriptions/mySub/Microsoft.Authorization/policySetDefinitions/myPSSetDefinition'
Remove-AzPolicySetDefinition -Id $PolicySetDefinition.ResourceId -Force

Der erste Befehl ruft eine Richtliniensatzdefinition mithilfe des Cmdlets "Get-AzPolicySetDefinition" ab. Der Befehl speichert ihn in der $PolicySetDefinition Variablen. Mit dem zweiten Befehl wird die durch die ResourceId-Eigenschaft von $PolicySetDefinition identifizierte Richtliniensatzdefinition entfernt.

Beispiel 2: [Backcompat] Entfernen der Richtliniensatzdefinition nach Ressourcen-ID

$PolicySetDefinition = Get-AzPolicySetDefinition -ResourceId '/subscriptions/mySub/Microsoft.Authorization/policySetDefinitions/myPSSetDefinition'
Remove-AzPolicySetDefinition -Id $PolicySetDefinition.ResourceId -Force -BackwardCompatible
True

Der erste Befehl ruft eine Richtliniensatzdefinition mithilfe des Cmdlets "Get-AzPolicySetDefinition" ab. Der Befehl speichert ihn in der $PolicySetDefinition Variablen. Mit dem zweiten Befehl wird die durch die ResourceId-Eigenschaft von $PolicySetDefinition identifizierte Richtliniensatzdefinition entfernt.

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

-Confirm

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

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

-Force

Wenn $true, überspringen Sie Bestätigungsaufforderungen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Die vollständige ID der abzurufenden Richtliniendefinition.

Typ:String
Aliases:ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

Der Name der Verwaltungsgruppe.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Der Name der abzurufenden Richtliniendefinition.

Typ:String
Aliases:PolicySetDefinitionName
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

IPolicyIdentity

String

Ausgaben

Boolean