Share via


Set-CMDeviceVariable

Modificar uma variável de dispositivo.

Syntax

Set-CMDeviceVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   [-PassThru]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceVariable
   -DeviceName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   [-PassThru]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceVariable
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   [-PassThru]
   -ResourceId <String>
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para modificar uma variável em um dispositivo do Configuration Manager.

Dispositivos individuais têm variáveis de dispositivo. O processamento da sequência de tarefas usa variáveis de dispositivo. Para obter mais informações, consulte Collection and device variables.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Modificar uma variável de dispositivo

Este comando modifica a variável de dispositivo ServerIPAddress associada à device.com. Neste exemplo, o valor da variável é definido como 192.168.100.10 .

Set-CMDeviceVariable -DeviceName "server01" -VariableName "ServerIPAddress" -NewVariableValue "192.168.100.10"

Parâmetros

-Confirm

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

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

-DeviceName

Especifique um nome de dispositivo. Você pode especificar um nome netBIOS ou um FQDN (nome de domínio totalmente qualificado).

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto de dispositivo no qual definir a variável. Para obter esse objeto, use o cmdlet Get-CMDevice.

Type:IResultObject
Aliases:Device
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-IsMask

De definir esse parâmetro $true para ocultar o valor no console do Configuration Manager.

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

-NewVariableName

Especifique um novo nome para a variável.

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

-NewVariableValue

Especifique um novo valor para a variável.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-ResourceId

Especifique a ID de recurso do dispositivo.

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

-VariableName

Especifique o nome da variável do dispositivo.

A partir da versão 2111, esse parâmetro não tem maiúsculas de minúsculas.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object