Remove-CMTaskSequence

  • Referenz
Modul:
ConfigurationManager

Entfernen sie eine Tasksequenz.

Syntax

Remove-CMTaskSequence
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMTaskSequence
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMTaskSequence
      [-Force]
      -TaskSequencePackageId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMTaskSequence entfernt eine Tasksequenz aus Configuration Manager.

Alle zugehörigen Bereitstellungen werden automatisch entfernt.

Hinweis

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

Beispiele

Beispiel 1: Entfernen einer Tasksequenz mithilfe einer Variablen

Der erste Befehl ruft das Tasksequenzobjekt mit dem Namen TaskSequence01 ab und speichert das Objekt in der variablen $TaskSequence .

Der zweite Befehl entfernt das in $TaskSequence gespeicherte Tasksequenzobjekt. Da der Parameter -Force nicht angegeben ist, fordert PowerShell den Benutzer auf, die Aktion zu bestätigen.

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Remove-CMTaskSequence -InputObject $TaskSequence
Remove
Are you sure you wish to remove TaskSequence: Name="General Sequence 11"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):

Beispiel 2: Entfernen einer Tasksequenz mithilfe der Pipeline

Dieser Befehl ruft das Tasksequenzobjekt mit dem Namen TaskSequence02 ab. Anschließend wird der Pipelineoperator verwendet, um das Objekt an Remove-CMTaskSequence zu übergeben, wodurch das Tasksequenzobjekt entfernt wird. Mit dem Force-Parameter fordert PowerShell den Benutzer nicht auf, bevor die Tasksequenz entfernt wird.

Get-CMTaskSequence -Name "TaskSequence02" | Remove-CMTaskSequence -Force

Parameter

-Confirm

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

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

-DisableWildcardHandling

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

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

-Force

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

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

-ForceWildcardHandling

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

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

-InputObject

Gibt ein Tasksequenzobjekt an. Verwenden Sie zum Abrufen eines Tasksequenzobjekts das Cmdlet Get-CMTaskSequence .

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

-Name

Gibt den Namen einer zu entfernenden Tasksequenz an.

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

-TaskSequencePackageId

Gibt die ID einer zu entfernenden Tasksequenz an.

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

-WhatIf

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

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object