Remove-CMDeviceCollectionVariable

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

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

Синтаксис

Remove-CMDeviceCollectionVariable
      -Collection <IResultObject>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionId <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionName <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

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

Дополнительные сведения см. в разделе Настройка переменных последовательности задач.

Примечание.

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

Примеры

Пример 1. Удаление переменной коллекции устройств

Первая команда получает объект коллекции устройств с именем Device и сохраняет его в переменной $Collection .

Вторая команда удаляет переменную коллекции устройств с именем testTS из коллекции устройств, хранящейся в переменной $Collection . Указание параметра Force означает, что перед удалением переменной запрос не запрашивается.

$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force

Пример 2. Удаление всех переменных из коллекции устройств

В этом примере сначала используется командлет Get-CMDeviceCollectionVariable , чтобы получить все переменные на ИТ-серверах коллекции устройств и сохранить объекты в переменной массива vars . Затем он циклически просматривает каждый элемент в массиве и удаляет переменную по имени.

Параметр Force используется, чтобы не было предложено удалить каждую переменную.

$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName

foreach ( $var in $vars ) {
  Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}

Так как параметр VariableName не разрешает использование подстановочных знаков, используйте этот процесс, если необходимо быстро очистить все переменные из коллекции устройств.

Параметры

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-Force

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

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

-ForceWildcardHandling

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

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

-VariableName

Укажите имя удаляемой переменной коллекции. Этот параметр не принимает подстановочные знаки.

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object