Compartilhar via

New-CMTSStepConditionRegistry

  • Referência
Módulo:
ConfigurationManager

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 HKeyLocalMachineRootKey, pode especificar a chave SOFTWARE\Microsoft\CCMde 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.