Delen via


New-CMDeviceVariable

SYNOPSIS

Hiermee maakt u een apparaatvariabele voor Configuration Manager apparaat.

SYNTAX

NewByValueMandatory (standaard)

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

NewByIdMandatory

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

NewByNameMandatory

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

DESCRIPTION

De cmdlet New-CMDeviceVariable maakt een apparaatvariabele voor een Configuration Manager apparaat.

Afzonderlijke apparaten hebben apparaatvariabelen. De takenreeksverwerking maakt gebruik van apparaatvariabelen.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een apparaatvariabele maken

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

Met deze opdracht maakt u een apparaatvariabele voor de gateway-server.contoso.com. De variabele heeft de naam ServerIPAddress en de waarde is ingesteld op 192.168.1.1. Als u de parameter IsMask instelt op 0, zorgt u ervoor dat de variabele wordt weergegeven in Configuration Manager console.

PARAMETERS

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DeviceId

Hiermee geeft u een apparaat-id op.

Type: String
Parameter Sets: NewByIdMandatory
Aliases:

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

-DeviceName

Hiermee geeft u een apparaatnaam op. U kunt een NetBIOS-naam of een FQDN (Fully Qualified Domain Name) opgeven.

Type: String
Parameter Sets: NewByNameMandatory
Aliases:

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Hiermee geeft u de invoer voor deze cmdlet. U kunt deze parameter gebruiken of u kunt de invoer doorseen naar deze cmdlet.

Type: IResultObject
Parameter Sets: NewByValueMandatory
Aliases: Device

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-IsMask

Geeft aan of de variabele waarde wordt weergegeven in de Configuration Manager console.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-VariableName

Hiermee geeft u de naam van de apparaatvariabele op.

Type: String
Parameter Sets: (All)
Aliases:

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

-VariableValue

Hiermee geeft u de waarde van de variabele.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_MachineSettings

OPMERKINGEN

Get-CMDeviceVariable

Remove-CMDeviceVariable

Set-CMDeviceVariable

Get-CMDevice