New-CMTSStepConditionRegistry
Crie uma condição de definição de registo para um passo de sequência de tarefas.
Sintaxe
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilize este cmdlet para criar um objeto de condição de definição de registo para um passo de sequência de tarefas. Em seguida, utilize um dos cmdlets New-CMTSStep* ou Set-CMTSStep* com os parâmetros Condition ou AddCondition . Por exemplo, Set-CMTSStepApplyDataImage.
Para obter mais informações, veja Utilizar o editor de sequência de tarefas: Condições.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1
Este exemplo cria primeiro o objeto de condição para a definição de registo que verifica o nível de registo do cliente do Configuration Manager.
Em seguida, utiliza o cmdlet Set-CMTSStepSetDynamicVariable para adicionar este objeto de condição ao passo Definir Variáveis Dinâmicas da sequência de tarefas de implementação do SO Predefinido .
$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 no passo:
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.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RegistryKey
Especifique o caminho da chave de registo a verificar. Por exemplo, com a HKeyLocalMachine
RootKey, pode especificar a chave SOFTWARE\Microsoft\CCM
de registo .
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RegistryOperator
Utilize este parâmetro para especificar o operador da sequência de tarefas para avaliar o valor do registo. Se utilizar os Exists
valores ou NotExists
, não precisa de utilizar o parâmetro RegistryValueData .
Tipo: | VariableOperatorType |
Valores aceitos: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RegistryValueData
Se utilizar um RegistryOperator comparativo como Equals
, utilize este parâmetro para especificar os dados de valor a avaliar. Utilize ValueType para especificar o tipo de registo.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RegistryValueName
Especifique o nome do valor do registo a verificar. Se não especificar este parâmetro, a condição verifica o valor (Predefinição) da Chave de Registo especificada.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RootKey
Especifique a chave raiz do registo a verificar.
Tipo: | RegistryRootKeyType |
Valores aceitos: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ValueType
Especifique o tipo de valor de registo a verificar. Utilize este parâmetro com o RegistryValueData para especificar os dados do valor.
Tipo: | RegistryValueType |
Valores aceitos: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_RegistryConditionExpression classe WMI de servidor.