New-CMTSStepConditionRegistry
Cree una condición de configuración del Registro para un paso de secuencia de tareas.
Syntax
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 Use the task sequence editor: Conditions.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
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 del 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 predeterminada del sistema operativo.
$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
Este 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryKey
Especifique la ruta de acceso de clave del Registro que se debe comprobar. Por ejemplo, con HKeyLocalMachine
RootKey, puede especificar la clave del Registro SOFTWARE\Microsoft\CCM
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryOperator
Use este parámetro para especificar el operador de la secuencia de tareas para evaluar el valor del Registro. Si usa los valores or, no es necesario usar el parámetro 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
Si usa un registryOperator comparativo como Equals
, use este parámetro para especificar los datos de valor que se deben evaluar. Use ValueType para especificar el tipo de Registro.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryValueName
Especifique el nombre del valor del Registro que se debe comprobar. Si no especifica este parámetro, la condición comprueba el valor (Predeterminado) de la clave de registro especificada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RootKey
Especifique la clave raíz del Registro que se debe comprobar.
Type: | RegistryRootKeyType |
Accepted values: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueType
Especifique el tipo de valor del Registro que se debe comprobar. Use este parámetro con RegistryValueData para especificar los datos de valor.
Type: | RegistryValueType |
Accepted values: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Ninguno
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_RegistryConditionExpression server WMI class.