New-CMGlobalConditionRegistryValue

  • Referência
Módulo:
ConfigurationManager

Cria uma condição global do tipo Valor de Registo no Configuration Manager.

Sintaxe

New-CMGlobalConditionRegistryValue
   -DataType <GlobalConditionDataType>
   [-Is64Bit <Boolean>]
   -KeyName <String>
   [-RegistryHive <RegistryRootKey>]
   [-ValueName <String>]
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

O cmdlet New-CMGlobalConditionRegistryValue cria uma condição global de tipo Valor de Registo no Configuration Manager.

Uma condição global é uma definição ou expressão no Configuration Manager que pode utilizar para especificar como o Configuration Manager fornece e implementa uma aplicação em clientes.

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

$GlobalRegValue = New-CMGlobalConditionRegistryValue -DataType String -KeyName key -Name GC4 -DeviceType WindowsMobile -RegistryHive LocalMachine -ValueName VName

Este comando cria uma condição global de tipo Valor de Registo no Configuration Manager.

Parâmetros

-DataType

Especifica um tipo de dados.

Tipo:GlobalConditionDataType
Valores aceitos:String, DateTime, Integer, FloatingPoint, Version, StringArray
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceType

Especifica um tipo de dispositivo.

Tipo:GlobalConditionDeviceType
Valores aceitos:Windows, WindowsMobile
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-Is64Bit

Especifica se as chaves de registo de 64 bits devem ser pesquisadas para além das chaves de registo de 32 bits nos clientes que executam uma versão de 64 bits do Windows.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KeyName

Especifica o nome da chave de registo que pretende procurar. O formato utilizado deve ser key\subkey.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RegistryHive

Especifica o ramo de registo no qual pretende procurar.

Tipo:RegistryRootKey
Valores aceitos:ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ValueName

Especifica o valor que tem de estar contido na 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

Entradas

None

Saídas

System.Object