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

Remove-CMCollection

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

Удалите коллекцию устройств или пользователей.

Синтаксис

Remove-CMCollection
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollection
      [-Force]
      -Id <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollection
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Используйте этот командлет для удаления коллекции устройств или пользователей.

Вы не можете удалить коллекции по умолчанию. Любое целевое семейство должно иметь идентификатор, который начинается с кода сайта, а не SMS.

Примечание.

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

Примеры

Пример 1. Удаление коллекции по имени

Эта команда удаляет коллекцию с именем testUser. Указание параметра Force означает, что перед удалением коллекции не запрашивается подтверждение.

Remove-CMCollection -Name "testUser" -Force

Пример 2. Получение объекта коллекции и его удаление

Эта команда получает объект коллекции с именем testUser и использует оператор конвейера для передачи его в Remove-CMCollection, который удаляет коллекцию.

Get-CMCollection -Name "testUser" | Remove-CMCollection

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера: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

-Id

Укажите идентификатор удаляемой коллекции. Это значение является свойством CollectionID , например XYZ00012. Вы не можете удалить коллекции по умолчанию, поэтому это значение начинается с кода сайта, а не SMS.

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

-InputObject

Укажите удаляемый объект коллекции. Чтобы получить этот объект, используйте командлеты Get-CMCollection, Get-CMDeviceCollection или Get-CMUserCollection .

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

-Name

Укажите имя удаляемой коллекции.

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object