Set-CMDeviceCollectionVariable

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

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

Синтаксис

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

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

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

Примечание.

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

Примеры

Пример 1. Изменение имени переменной

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

Вторая команда изменяет имя переменной коллекции testTS на NewVariable.

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

Пример 2. Изменение значения переменной

Эта команда изменяет значение переменной testTS в коллекции Device . Для новой переменной устанавливается значение 12.

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

Параметры

-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

-ForceWildcardHandling

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

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

-InputObject

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

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

-IsMask

Присвойте этому параметру значение , $true чтобы указать, что значение переменной скрыто. Маскированные значения не отображаются в консоли Configuration Manager, в свойстве Value класса WMI SMS_CollectionVariable или в файле журнала последовательности задач. Последовательность задач по-прежнему может использовать переменную.

Вы не можете отменить маску переменной после ее скрытия. Если вы маскировали значение переменной, но не хотите, чтобы оно маскировалось, необходимо удалить и повторно создать переменную.

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

-NewVariableName

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

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

-NewVariableValue

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

Type:String
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

Примечания

Чтобы задать приоритет переменной, используйте командлет Set-CMCollection с параметром VariablePriority . Чтобы просмотреть текущий приоритет переменной, используйте командлет Get-CMCollectionSetting .