New-CMTSStepConditionRegistry
为 任务序列步骤 创建注册表设置条件。
语法
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 为任务 序列 步骤创建注册表设置条件对象。 然后，将New-CMTSStep * _ 或 _ Set-CMTSStep * _ cmdlet 之一与 _ Condition 或AddCondition参数一同使用。 例如 ，Set-CMTSStepApplyDataImage。
有关详细信息，请参阅使用任务 序列编辑器：条件。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。
示例
示例 1
此示例首先为检查 Configuration Manager 客户端日志级别的注册表设置创建条件对象。
然后，它使用Set-CMTSStepSetDynamicVariable cmdlet 将此条件对象添加到默认操作系统部署任务序列的 " 设置动态变量"步骤中。
$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
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryKey
指定要检查的注册表项路径。 例如，使用 HKeyLocalMachine RootKey，可以指定注册表项 SOFTWARE\Microsoft\CCM 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryOperator
使用此参数指定任务序列的运算符以计算注册表值。 如果使用 或 Exists 值，则 NotExists 无需使用 RegistryValueData 参数。
| Type: | VariableOperatorType |
| Accepted values: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryValueData
如果使用比较 RegistryOperator（ 如 Equals ），请使用此参数指定要计算的值数据。 使用 ValueType 指定注册表类型。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryValueName
指定要检查的注册表值的名称。 如果不指定此参数，则条件将检查 (** 的 Default **) 注册表项 的值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RootKey
指定要检查的注册表根项。
| Type: | RegistryRootKeyType |
| Accepted values: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueType
指定要检查的注册表值的类型。 此参数与 RegistryValueData 一起用于指定值数据。
| Type: | RegistryValueType |
| Accepted values: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
无
输出
IResultObject
备注
有关此返回对象及其属性的信息，请参阅SMS_TaskSequence_RegistryConditionExpression WMI 类。