Compartir a través de

Remove-CMDeployment

  • Referencia
Módulo:
ConfigurationManager

Quita una implementación.

Sintaxis

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 de Configuration Manager, por ejemplo PS 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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CollectionName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeploymentId

Especifica el identificador de una implementación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

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

Tipo:IResultObject
Alias:Deployment
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object