New-CMTSStepConditionRegistry
建立任務順序步驟的登錄 設定 條件。
Syntax
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 來建立任務順序步驟的登錄 設定 條件物件。 然後,使用其中一個CMTSStep * _ 或 _ Set-CMTSStep * _ Cmdlet 搭配 _ Condition或AddCondition參數。 例如, Set-CMTSStepApplyDataImage。
如需詳細資訊,請參閱 使用任務順序編輯器:條件。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例 1
這個範例會先建立檢查 Configuration Manager 用戶端記錄層級之登錄設定的 condition 物件。
然後,它會使用CMTSStepSetDynamicVariable 指令程式,將此 condition 物件新增至預設 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 之前提示您確認。
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
指定要檢查的登錄值名稱。 如果您未指定此參數,則條件會檢查指定之RegistryKey的** (預設) **值。
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
備註
如需此 return 物件及其屬性的詳細資訊,請參閱 SMS_TaskSequence_RegistryConditionExpression SERVER WMI 類別。