New-CMTSStepConditionRegistry
Создайте условие параметра реестра для шага последовательности задач.
Синтаксис
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Используйте этот командлет, чтобы создать объект условия параметра реестра для шага последовательности задач. Затем используйте один из командлетов New-CMTSStep* или Set-CMTSStep* с параметрами Condition или AddCondition . Например, Set-CMTSStepApplyDataImage.
Дополнительные сведения см . в разделе Использование редактора последовательности задач: Условия.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1
В этом примере сначала создается объект условия для параметра реестра, который проверяет уровень журнала клиента Configuration Manager.
Затем он использует командлет Set-CMTSStepSetDynamicVariable , чтобы добавить этот объект условия на шаг Задать динамические переменные последовательности задач развертывания ОС по умолчанию .
$root = "HKeyLocalMachine"
$key = "SOFTWARE\Microsoft\CCM\Logging\@Global"
$name = "LogLevel"
$type = "RegistryDWord"
$value = 1
$condition = New-CMTSStepConditionRegistry -RootKey $root -RegistryKey $key -RegistryOperator Equals -RegistryValueName $name -ValueType $type -RegistryValueData $value
$tsNameOsd = "Default OS deployment"
$tsStepNameDynVar = "Set Dynamic Variables"
Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameDynVar -AddCondition $conditionЭтот пример скрипта создает следующее условие на шаге:
Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"
Параметры
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | 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 |
-RegistryKey
Укажите путь к разделу реестра для проверки. Например, с помощью HKeyLocalMachineRootKey можно указать раздел SOFTWARE\Microsoft\CCMреестра .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RegistryOperator
Используйте этот параметр, чтобы указать оператор для последовательности задач для оценки значения реестра. Если вы используете Exists значения или NotExists , вам не нужно использовать параметр RegistryValueData .
| Тип: | VariableOperatorType |
| Допустимые значения: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RegistryValueData
Если вы используете сопоставительный RegistryOperator , например Equals, используйте этот параметр, чтобы указать значения для оценки. Используйте ValueType , чтобы указать тип реестра.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RegistryValueName
Укажите имя проверяемого значения реестра. Если этот параметр не указан, условие проверяет значение (по умолчанию) указанного registryKey.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RootKey
Укажите корневой раздел реестра для проверки.
| Тип: | RegistryRootKeyType |
| Допустимые значения: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ValueType
Укажите тип проверяемого значения реестра. Используйте этот параметр вместе с RegistryValueData , чтобы указать данные значения.
| Тип: | RegistryValueType |
| Допустимые значения: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_RegistryConditionExpression класс WMI сервера.