Freigeben über

Remove-CMDeployment

  • Referenz
Modul:
ConfigurationManager

Entfernt eine Bereitstellung.

Syntax

Remove-CMDeployment
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeployment
      -ApplicationName <String>
      -DeploymentId <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeployment
      -ApplicationName <String>
      -CollectionName <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMDeployment entfernt eine Anwendungsbereitstellung aus Configuration Manager.

Wenn Sie eine Anwendungsbereitstellung entfernen, entfernt Configuration Manager keine Instanzen der Anwendung, die bereits installiert wurde. Um diese Anwendungen zu entfernen, müssen Sie die Anwendung mit der Aktion Deinstallieren auf Computern bereitstellen. Wenn Sie eine Anwendungsbereitstellung löschen oder eine Ressource aus der Sammlung entfernen, in der Sie die Bereitstellung durchführen, ist die Anwendung nicht mehr im Softwarecenter sichtbar.

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 Anwendungsbereitstellung

PS XYZ:\> Remove-CMDeployment -ApplicationName "CMappD01" -CollectionName "All Users"

Dieser Befehl entfernt die Configuration Manager-Bereitstellung, die der Anwendung mit dem Namen CMappD01 zugeordnet ist und auf die Sammlung mit dem Namen Alle Benutzer angewendet wird.

Beispiel 2: Übergeben eines Bereitstellungsobjekts und Entfernen des Objekts

PS XYZ:\> Get-CMDeployment -CollectionName "deviceCol01" -FeatureType Application | Remove-CMDeployment -Force

Dieser Befehl ruft das angegebene Anwendungsbereitstellungsobjekt für die Auflistung mit dem Namen deiceCol01 ab und verwendet den Pipelineoperator, um das Objekt an Remove-CMDeployment zu übergeben, wodurch die Bereitstellung entfernt wird. Da der Force-Parameter angegeben ist, wird der Benutzer nicht aufgefordert, bevor die Bereitstellung entfernt wird.

Beispiel 3: Entfernen einer Bereitstellung anhand ihrer ID

PS XYZ:\> Remove-CMDeployment -DeploymentId "{890082B6-7C16-4600-8807-7E0003BC9D99}" -ApplicationName "application01" -Force

Dieser Befehl entfernt die Bereitstellung mit dem Namen application01 mit der angegebenen ID. Da der Force-Parameter angegeben ist, wird der Benutzer nicht aufgefordert, bevor die Bereitstellung entfernt wird.

Parameter

-ApplicationName

Gibt den Namen der Anwendung an, die der Bereitstellung zugeordnet ist.

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

-CollectionName

Gibt den Namen der Sammlung an, die der Bereitstellung zugeordnet ist.

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

-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

-DeploymentId

Gibt die ID einer Bereitstellung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

Führt die Aktion ohne Bestätigungsmeldung aus.

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 Bereitstellungsobjekt an. Verwenden Sie zum Abrufen eines Bereitstellungsobjekts das Cmdlet Get-CMDeployment.

Typ:IResultObject
Aliase:Deployment
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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