Freigeben über

New-CMTSStepConditionRegistry

  • Referenz
Modul:
ConfigurationManager

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 $condition

Dieses 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.