Compartilhar via

Set-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

Configurar uma variável de coleção de dispositivos.

Sintaxe

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para alterar uma variável de coleção de dispositivos.

As coleções predefinidas não podem ter variáveis. Qualquer coleção que tenha como destino deve ter um ID que comece com o código do site, não SMScom .

Para obter mais informações, veja Como definir variáveis de sequência de tarefas.

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: Alterar um nome de variável

O primeiro comando obtém o objeto de coleção de dispositivos denominado Dispositivo e armazena-o na variável $Collection .

O segundo comando altera o nome da variável de coleção testTS para NewVariable.

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

Exemplo 2: Alterar um valor de variável

Este comando altera o valor da variável testTS na Coleção de dispositivos . Define o valor da nova variável como 12.

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

Parâmetros

-CollectionId

Especifique o ID de uma coleção de dispositivos para configurar uma variável. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Uma vez que não pode definir variáveis em coleções predefinidas, este valor começa com o código do site, não SMScom .

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

-CollectionName

Especifique o nome de uma coleção de dispositivos para configurar uma variável.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
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

-InputObject

Especifique um objeto de coleção de dispositivos para configurar uma variável. Para obter este objeto, utilize os cmdlets Get-CMCollection ou Get-CMDeviceCollection .

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

-IsMask

Defina este parâmetro como $true para indicar que o valor da variável está oculto. Os valores mascarados não são apresentados na consola do Configuration Manager, na propriedade Valor na classe WMI SMS_CollectionVariable ou no ficheiro de registo da sequência de tarefas. A sequência de tarefas ainda pode utilizar a variável .

Não pode desmascarar uma variável depois de estar ocultada. Se mascarar o valor de uma variável, mas não quiser mascará-la, terá de eliminar e recriar a variável.

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

-NewVariableName

Especifique um novo nome para a variável de coleção. Utilize este parâmetro para mudar o nome da variável.

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

-NewVariableValue

Especifique um novo valor para a variável de coleção.

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

-VariableName

Especifique o nome da variável de coleção a alterar.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Observações

Para definir a prioridade da variável, utilize o cmdlet Set-CMCollection com o parâmetro VariablePriority . Para ver a prioridade atual da variável, utilize o cmdlet Get-CMCollectionSetting .