Remove-CMConfigurationPolicy

  • Referenz
Modul:
ConfigurationManager

Entfernt eine Konfigurationsrichtlinie.

Syntax

Remove-CMConfigurationPolicy
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationPolicy
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationPolicy
      [-Force]
      [-Name] <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMConfigurationPolicy entfernt eine Konfigurationsrichtlinie. Eine Konfigurationsrichtlinie kann ein E-Mail-Profil, eine Firewallrichtlinie oder andere sein. Weitere Richtlinientypen, die Sie mit diesem Cmdlet entfernen können, finden Sie im Abschnitt Alias.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Entfernen einer Konfigurationsrichtlinie nach ID

PS XYZ:\> Remove-CMConfigurationPolicy -ID 16777454 -Force

Dieser Befehl entfernt die Konfigurationsrichtlinie mit dem CI_ID von 16777454, ohne den Benutzer zur Bestätigung aufzufordern.

Beispiel 2: Entfernen einer Konfigurationsrichtlinie anhand des Namens

PS XYZ:\> Get-CMcertificateProfilePfx -Name "CertProf1" | Remove-CMConfigurationPolicy

Dieser Befehl ruft das PFX-Zertifikatprofilobjekt certProf01 ab und verwendet den Pipelineoperator, um das Objekt an Remove-CMConfigurationPolicy zu übergeben, wodurch das Zertifikatprofil entfernt wird.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Gibt die CI__ID einer Konfigurationsrichtlinie an.

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Gibt ein Konfigurationsrichtlinienobjekt an. Verwenden Sie das Cmdlet Get-CMConfigurationPolicy, um ein Konfigurationsrichtlinienobjekt abzurufen.

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt ein Array von Namen von Konfigurationsrichtlinien an.

Type:String[]
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object