New-CMTSStepConditionRegistry
Cree una condición de configuración del Registro para un paso de secuencia de tareas.
Sintaxis
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Use este cmdlet para crear un objeto de condición de configuración del Registro para un paso de secuencia de tareas. A continuación, use uno de los cmdlets New-CMTSStep* o Set-CMTSStep* con los parámetros Condition o AddCondition . Por ejemplo, Set-CMTSStepApplyDataImage.
Para obtener más información, vea Usar el editor de secuencia de tareas: Condiciones.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1
En este ejemplo se crea primero el objeto de condición para la configuración del Registro que comprueba el nivel de registro de cliente de Configuration Manager.
A continuación, usa el cmdlet Set-CMTSStepSetDynamicVariable para agregar este objeto de condición al paso Establecer variables dinámicas de la secuencia de tareas de implementación del sistema operativo predeterminado .
$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 $conditionEste script de ejemplo crea la siguiente condición en el paso:
Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"
Parámetros
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RegistryKey
Especifique la ruta de acceso de la clave del Registro que se va a comprobar. Por ejemplo, con RootKeyHKeyLocalMachine, puede especificar la clave SOFTWARE\Microsoft\CCMdel Registro .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RegistryOperator
Use este parámetro para especificar el operador de la secuencia de tareas para evaluar el valor del Registro. Si usa los Exists valores o NotExists , no es necesario usar el parámetro RegistryValueData .
| Tipo: | VariableOperatorType |
| Valores aceptados: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RegistryValueData
Si usa un RegistryOperator comparativo como Equals, use este parámetro para especificar los datos de valor que se van a evaluar. Use ValueType para especificar el tipo de registro.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RegistryValueName
Especifique el nombre del valor del Registro que se va a comprobar. Si no especifica este parámetro, la condición comprueba el valor (Predeterminado) de la RegistryKey especificada.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RootKey
Especifique la clave raíz del Registro que se va a comprobar.
| Tipo: | RegistryRootKeyType |
| Valores aceptados: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ValueType
Especifique el tipo de valor del Registro que se va a comprobar. Use este parámetro con RegistryValueData para especificar los datos del valor.
| Tipo: | RegistryValueType |
| Valores aceptados: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_RegistryConditionExpression clase WMI de servidor.