New-CMTSStepConditionRegistry
Creare una condizione di impostazione del Registro di sistema per un passaggio della sequenza di attività.
Sintassi
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Usare questo cmdlet per creare un oggetto condizione di impostazione del Registro di sistema per un passaggio della sequenza di attività. Usare quindi uno dei cmdlet New-CMTSStep* o Set-CMTSStep* con i parametri Condition o AddCondition . Ad esempio, Set-CMTSStepApplyDataImage.
Per altre informazioni, vedere Usare l'editor della sequenza di attività: Condizioni.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.
Esempio
Esempio 1
In questo esempio viene innanzitutto creato l'oggetto condizione per l'impostazione del Registro di sistema che controlla il livello di log client di Configuration Manager.
Usa quindi il cmdlet Set-CMTSStepSetDynamicVariable per aggiungere questo oggetto condizione al passaggio Imposta variabili dinamiche della sequenza di attività di distribuzione del sistema operativo predefinito .
$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 $conditionQuesto script di esempio crea la condizione seguente nel passaggio:
Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"
Parametri
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RegistryKey
Specificare il percorso della chiave del Registro di sistema da controllare. Ad esempio, con RootKeyHKeyLocalMachine, è possibile specificare la chiave SOFTWARE\Microsoft\CCMdel Registro di sistema .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RegistryOperator
Utilizzare questo parametro per specificare l'operatore per la sequenza di attività per valutare il valore del Registro di sistema. Se si usano i Exists valori o NotExists , non è necessario usare il parametro RegistryValueData .
| Tipo: | VariableOperatorType |
| Valori accettati: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RegistryValueData
Se si usa un oggetto RegistryOperator comparativo come Equals, usare questo parametro per specificare i dati del valore da valutare. Usare ValueType per specificare il tipo di Registro di sistema.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RegistryValueName
Specificare il nome del valore del Registro di sistema da controllare. Se non si specifica questo parametro, la condizione controlla il valore (predefinito) dell'oggetto RegistryKey specificato.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RootKey
Specificare la chiave radice del Registro di sistema da controllare.
| Tipo: | RegistryRootKeyType |
| Valori accettati: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ValueType
Specificare il tipo di valore del Registro di sistema da controllare. Utilizzare questo parametro con RegistryValueData per specificare i dati del valore.
| Tipo: | RegistryValueType |
| Valori accettati: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
None
Output
IResultObject
Note
Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_RegistryConditionExpression classe WMI del server.