Поделиться через

Remove-CMDeployment

  • Ссылка
Модуль:
ConfigurationManager

Удаляет развертывание.

Синтаксис

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

Описание

Командлет Remove-CMDeployment удаляет развертывание приложения из Configuration Manager.

При удалении развертывания приложения Configuration Manager не удаляет экземпляры уже установленного приложения. Чтобы удалить эти приложения, необходимо развернуть приложение на компьютерах с действием Удалить. Если удалить развертывание приложения или ресурс из коллекции, в который выполняется развертывание, приложение больше не будет отображаться в Центре программного обеспечения.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Удаление развертывания приложения

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

Эта команда удаляет развертывание Configuration Manager, связанное с приложением CMappD01 и применяемое к коллекции All Users.

Пример 2. Передача объекта развертывания и его удаление

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

Эта команда получает указанный объект развертывания приложения для коллекции deiceCol01 и использует оператор конвейера для передачи объекта в Remove-CMDeployment, который удаляет развертывание. Так как указан параметр Force , пользователю не будет предложено перед удалением развертывания.

Пример 3. Удаление развертывания по идентификатору

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

Эта команда удаляет развертывание с именем application01 с указанным идентификатором. Так как указан параметр Force , пользователю не будет предложено перед удалением развертывания.

Параметры

-ApplicationName

Указывает имя приложения, связанного с развертыванием.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionName

Указывает имя коллекции, связанной с развертыванием.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeploymentId

Указывает идентификатор развертывания.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Выполняет действие без сообщения подтверждения.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Указывает объект развертывания. Чтобы получить объект развертывания, используйте командлет Get-CMDeployment.

Тип:IResultObject
Aliases:Deployment
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object