Share via

New-CMDeviceVariable

  • Referência
Módulo:
ConfigurationManager

Cria uma variável de dispositivo para um dispositivo Configuration Manager.

Syntax

New-CMDeviceVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   -VariableName <String>
   [-VariableValue <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceVariable
   -DeviceId <String>
   [-IsMask <Boolean>]
   -VariableName <String>
   [-VariableValue <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceVariable
   -DeviceName <String>
   [-IsMask <Boolean>]
   -VariableName <String>
   [-VariableValue <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMDeviceVariable cria uma variável de dispositivo para um dispositivo Configuration Manager.

Dispositivos individuais têm variáveis de dispositivo. O processamento de sequência de tarefas usa variáveis de dispositivo.

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: Criar uma variável de dispositivo

PS XYZ:\> New-CMDeviceVariable -DeviceName "gateway-server.contoso.com" -VariableName "ServerIPAddress" -VariableValue "192.168.1.1" -IsMask 0

Esse comando cria uma variável de dispositivo para o dispositivo gateway-server.contoso.com. A variável se chama ServerIPAddress e o valor é definido como 192.168.1.1. Definir o parâmetro IsMask como 0 garante que a variável seja exibida no console Configuration Manager.

Parâmetros

-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

-DeviceId

Especifica uma ID do dispositivo.

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

-DeviceName

Especifica 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
Required:True
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

Especifica a entrada para este cmdlet. Você pode usar esse parâmetro ou pode canalizar a entrada para este cmdlet.

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

-IsMask

Indica se o valor da variável é exibido no console Configuration Manager.

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

-VariableName

Especifica o nome da variável de dispositivo.

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

-VariableValue

Especifica o valor da variável.

Type:String
Position:Named
Default value:None
Required:False
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

IResultObject