New-CMTSStepConditionRegistry
Erstellen Sie eine Registrierungseinstellungsbedingung für einen Tasksequenzschritt.
Syntax
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie dieses Cmdlet, um ein Registrierungseinstellungsbedingungsobjekt für einen Tasksequenzschritt zu erstellen. Verwenden Sie dann eines der Cmdlets New-CMTSStep* oder Set-CMTSStep* mit den Parametern Condition oder AddCondition . Beispiel: Set-CMTSStepApplyDataImage.
Weitere Informationen finden Sie unter Verwenden des Tasksequenz-Editors: Bedingungen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
In diesem Beispiel wird zunächst das Bedingungsobjekt für die Registrierungseinstellung erstellt, mit der die Protokollebene des Configuration Manager-Clients überprüft wird.
Anschließend wird das Cmdlet Set-CMTSStepSetDynamicVariable verwendet, um dieses Bedingungsobjekt dem Schritt Dynamische Variablen festlegen der Tasksequenz Standardbetriebssystembereitstellung hinzuzufügen.
$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 $conditionDieses Beispielskript erstellt die folgende Bedingung für den Schritt:
Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"
Parameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RegistryKey
Geben Sie den zu überprüfenden Registrierungsschlüsselpfad an. Beispielsweise können Sie mit dem HKeyLocalMachineRootKey den Registrierungsschlüssel SOFTWARE\Microsoft\CCMangeben.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RegistryOperator
Verwenden Sie diesen Parameter, um den Operator für die Tasksequenz anzugeben, um den Registrierungswert auszuwerten. Wenn Sie die Exists Werte oder NotExists verwenden, müssen Sie den Parameter RegistryValueData nicht verwenden.
| Typ: | VariableOperatorType |
| Zulässige Werte: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RegistryValueData
Wenn Sie einen vergleichbaren RegistryOperator wie Equalsverwenden, verwenden Sie diesen Parameter, um die auszuwertenden Wertdaten anzugeben. Verwenden Sie ValueType , um den Registrierungstyp anzugeben.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RegistryValueName
Geben Sie den Namen des zu überprüfenden Registrierungswerts an. Wenn Sie diesen Parameter nicht angeben, überprüft die Bedingung den Wert (Standardwert) des angegebenen RegistryKey.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RootKey
Geben Sie den zu überprüfenden Registrierungsstammschlüssel an.
| Typ: | RegistryRootKeyType |
| Zulässige Werte: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ValueType
Geben Sie den Typ des zu überprüfenden Registrierungswerts an. Verwenden Sie diesen Parameter mit RegistryValueData , um die Wertdaten anzugeben.
| Typ: | RegistryValueType |
| Zulässige Werte: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_RegistryConditionExpression WMI-Serverklasse.