New-CMTSStepConditionRegistry
建立工作順序步驟的 登錄設定 條件。
語法
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 建立工作順序步驟的 登錄設定 條件物件。 然後使用其中一 個 New-CMTSStep* 或 Set-CMTSStep* Cmdlet 搭配 Condition 或 AddCondition 參数。 例如， Set-CMTSStepApplyDataImage。
如需詳細資訊，請 參閱使用工作順序編輯器：條件。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1
此範例會先針對檢查 Configuration Manager 用戶端記錄層級的登錄設定建立條件物件。
然後，它會使用 Set-CMTSStepSetDynamicVariable Cmdlet，將此條件物件新增至預設 OS 部署工作順序的 [設定動態變數] 步驟。
$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 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RegistryKey
指定要檢查的登錄機碼路徑。 例如，您可以使用 HKeyLocalMachineRootKey 指定登入機碼 SOFTWARE\Microsoft\CCM。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RegistryOperator
使用此參數來指定工作順序的運算元，以評估登錄值。 如果您使用 Exists 或 NotExists 值，則不需要使用 RegistryValueData 參數。
| 類型: | VariableOperatorType |
| 接受的值: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RegistryValueData
如果您使用 如Equals的比較 RegistryOperator，請使用此參數來指定要評估的值數據。 使用 ValueType 指定登錄類型。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RegistryValueName
指定要檢查的登錄值名稱。 如果您未指定此參數，條件會檢查 (指定之 RegistryKey 的預設) 值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RootKey
指定要檢查的登錄根金鑰。
| 類型: | RegistryRootKeyType |
| 接受的值: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ValueType
指定要檢查的登錄值類型。 使用此參數搭配 RegistryValueData 來指定值數據。
| 類型: | RegistryValueType |
| 接受的值: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_TaskSequence_RegistryConditionExpression伺服器 WMI 類別。