Get-CMDeviceVariable
Get-CMDeviceVariable
Gets device variables.
Syntax
Parameter Set: SearchByIdMandatory
Get-CMDeviceVariable -ResourceId <String> -VariableName <String> [ <CommonParameters>]
Parameter Set: SearchByNameMandatory
Get-CMDeviceVariable -DeviceName <String> -VariableName <String> [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Get-CMDeviceVariable -Device <IResultObject> -VariableName <String> [ <CommonParameters>]
Detailed Description
The Get-CMDeviceVariable cmdlet gets device variables. Individual devices have device variables. Task sequence processing uses device variables.
Parameters
-Device<IResultObject>
Specifies a CMDevice object. To obtain a CMDevice object, use the Get-CMDevice cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceName<String>
Specifies a device name. You can specify a NetBIOS name or a fully qualified domain name (FQDN).
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ResourceId<String>
Specifies a Systems Management Server (SMS) ID.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-VariableName<String>
Specifies the name of the device variable.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Get a variable value by name
This command gets the value of the variable named HostDrive for the specified computer.
PS C:\> Get-CMDeviceVariable -DeviceName "Computer073" -VariableName "HostDrive"