New-CMTSStepConditionRegistry
Crie uma condição de configuração do Registro para uma etapa de sequência de tarefas.
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 criar um objeto de condição de configuração do Registro para uma etapa de sequência de tarefas. Em seguida, use um dos ** * ** * cmdletsNew-CMTSStep _ ou _ Set-CMTSStep _** com os parâmetros _ Condition ou AddCondition. Por exemplo, Set-CMTSStepApplyDataImage.
Para obter mais informações, consulte Use the task sequence editor: Conditions.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1
Este exemplo cria primeiro o objeto condition para a configuração do Registro que verifica o nível de log do cliente do Configuration Manager.
Em seguida, ele usa o cmdlet Set-CMTSStepSetDynamicVariable para adicionar esse objeto de condição à etapa Definir Variáveis Dinâmicas da sequência de tarefas de implantação do sistema operacional padrão.
$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 exemplo cria a seguinte condição na etapa:
Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"
Parâmetros
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryKey
Especifique o caminho da chave do Registro a ser consultado. Por exemplo, com HKeyLocalMachine
o RootKey, você pode especificar a chave do 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 o operador da sequência de tarefas para avaliar o valor do Registro. Se você usar Exists
os valores NotExists
ou, então, não precisará usar o parâmetro 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
Se você usar um RegistryOperator comparativo como , use esse Equals
parâmetro para especificar os dados de valor a avaliar. Use ValueType para especificar o tipo de registro.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryValueName
Especifique o nome do valor do Registro a ser consultado. Se você não especificar esse parâmetro, a condição verificará o valor (Padrão) do RegistryKey especificado.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RootKey
Especifique a chave raiz do Registro a ser consultada.
Type: | RegistryRootKeyType |
Accepted values: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueType
Especifique o tipo de valor do Registro a ser consultado. Use esse parâmetro com o RegistryValueData para especificar os dados de valor.
Type: | RegistryValueType |
Accepted values: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_RegistryConditionExpression classe WMI do servidor.