Compartilhar via

Set-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

Configure 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

Use esse cmdlet para alterar uma variável de coleção de dispositivos.

Coleções padrão não podem ter variáveis. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS.

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

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: alterar um nome de variável

O primeiro comando obtém o objeto de coleção de dispositivos chamado Dispositivo e o armazena 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 variável

Esse comando altera o valor do testTS variável na coleção Dispositivo . Ele define o novo valor de variável como 12.

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

Parâmetros

-CollectionId

Especifique a ID de uma coleção de dispositivos para configurar uma variável. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Como você não pode definir variáveis em coleções padrão, esse 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

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 esse objeto, use 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 esse parâmetro para $true indicar que o valor da variável está oculto. Os valores mascarados não são exibidos no console Configuration Manager, na propriedade Value na classe WMI SMS_CollectionVariable ou no arquivo de log de sequência de tarefas. A sequência de tarefas ainda pode usar a variável.

Não é possível desmascarar uma variável quando ela estiver oculta. Se você mascarar o valor de uma variável, mas não quiser mascarada, precisará excluir 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. Use esse parâmetro para renomear a 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 ser alterada.

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, use o cmdlet Set-CMCollection com o parâmetro VariablePriority . Para exibir a prioridade da variável atual, use o cmdlet Get-CMCollectionSetting .