Set-CMDeviceCollectionVariable
Настройка переменной коллекции устройств.
Синтаксис
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.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CollectionName
Укажите имя коллекции устройств для настройки переменной.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект коллекции устройств для настройки переменной. Чтобы получить этот объект, используйте командлеты Get-CMCollection или Get-CMDeviceCollection .
| Тип: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-IsMask
Задайте этому параметру значение , $true чтобы указать, что значение переменной скрыто. Маскированные значения не отображаются в консоли Configuration Manager, свойстве Value класса WMI SMS_CollectionVariable или в файле журнала последовательности задач. Последовательность задач по-прежнему может использовать переменную.
Вы не можете отменить маску переменной после ее скрытия. Если вы маскировали значение переменной, но не хотите, чтобы оно маскировалось, необходимо удалить и повторно создать переменную.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewVariableName
Укажите новое имя для переменной коллекции. Используйте этот параметр для переименования переменной.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewVariableValue
Укажите новое значение для переменной коллекции.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-VariableName
Укажите имя переменной коллекции для изменения.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object
Примечания
Чтобы задать приоритет переменной, используйте командлет Set-CMCollection с параметром VariablePriority . Чтобы просмотреть текущий приоритет переменной, используйте командлет Get-CMCollectionSetting .