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 sie bereits installiert hat. 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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 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.

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

-CollectionName

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

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

-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

-DeploymentId

Gibt die ID einer Bereitstellung an.

Type:String
Position:Named
Default value:None
Required:True
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

Führt die Aktion ohne Bestätigungsmeldung aus.

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

-InputObject

Gibt ein Bereitstellungsobjekt an. Verwenden Sie zum Abrufen eines Bereitstellungsobjekts das Cmdlet Get-CMDeployment.

Type:IResultObject
Aliases:Deployment
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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