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

Remove-CMConfigurationItem

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

Удаляет элементы конфигурации из Configuration Manager.

Синтаксис

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

Описание

Командлет Remove-CMConfigurationItem удаляет указанные элементы конфигурации из Configuration Manager. Элементы можно указать по идентификатору, имени или с помощью командлета .

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

При удалении элемента конфигурации, развернутого в коллекции, развертывание также будет удалено.

Дополнительные сведения об элементах конфигурации см. в статье Общие сведения о параметрах соответствия в Configuration Manager.

Примечание.

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

Примеры

Пример 1. Удаление элемента с помощью идентификатора

PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"

Эта команда удаляет элемент конфигурации с указанным идентификатором.

Пример 2. Удаление элемента с помощью имени

PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"

Эта команда удаляет элемент конфигурации с именем ConfigItem76.

Пример 3. Удаление элемента с помощью переменной

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

Первая команда получает элемент конфигурации с указанным идентификатором и сохраняет его в переменной $CIObj.

Вторая команда удаляет элемент, хранящийся в переменной $CIObj.

Параметры

-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

Задает массив идентификаторов для одного или нескольких элементов конфигурации. Можно использовать список, разделенный запятыми.

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

-InputObject

Указывает объект элемента конфигурации. Чтобы получить объект элемента конфигурации, можно использовать командлет Get-CMConfigurationItem .

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

-Name

Задает массив имен элементов конфигурации.

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object