Share via

Set-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

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

Syntax

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 .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewVariableName

Especifique um novo nome para a variável de coleção. Use esse parâmetro para renomear a variável.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewVariableValue

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VariableName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .