Remove-CMDeployment

  • Referencia
Módulo:
ConfigurationManager

Quita una implementación.

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>]

Description

El cmdlet Remove-CMDeployment quita una implementación de aplicación de Configuration Manager.

Al quitar una implementación de aplicación, Configuration Manager no quita las instancias de la aplicación que ya tiene instalada. Para quitar estas aplicaciones, debe implementar la aplicación en equipos con la acción Desinstalar. Si elimina una implementación de aplicación o quita un recurso de la colección en la que va a realizar la implementación, la aplicación dejará de estar visible en el Centro de software.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Eliminación de una implementación de aplicación

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

Este comando quita la implementación de Configuration Manager asociada a la aplicación denominada CMappD01 y que se aplica a la colección denominada Todos los usuarios.

Ejemplo 2: Pasar un objeto de implementación y quitarlo

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

Este comando obtiene el objeto de implementación de aplicación especificado para la colección denominada deiceCol01 y usa el operador de canalización para pasar el objeto a Remove-CMDeployment, lo que quita la implementación. Dado que se especifica el parámetro Force , no se solicita al usuario antes de quitar la implementación.

Ejemplo 3: Eliminación de una implementación por su identificador

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

Este comando quita la implementación denominada application01 con el identificador especificado. Dado que se especifica el parámetro Force , no se solicita al usuario antes de quitar la implementación.

Parámetros

-ApplicationName

Especifica el nombre de la aplicación asociada a la implementación.

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

-CollectionName

Especifica el nombre de la colección asociada a la implementación.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-DeploymentId

Especifica el identificador de una implementación.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-Force

Realiza la acción sin un mensaje de confirmación.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifica un objeto de implementación. Para obtener un objeto de implementación, use el cmdlet Get-CMDeployment.

Type:IResultObject
Aliases:Deployment
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object