PROVIDER NAME
Variable
DRIVES
Variable:
SHORT DESCRIPTION
Provides access to the Windows PowerShell variables and to their values.
DETAILED DESCRIPTION
The Windows PowerShell Variable provider lets you get, add, change, clear, and delete Windows PowerShell variables in the current console.
The Windows PowerShell Variable provider supports the variables that Windows PowerShell creates, including the automatic variables, the preference variables, and the variables that you create.
The Variable provider is a flat namespace that contains only the variable objects. The variables have no child items.
Most of the variables are instances of the System.Management.Automation.PSVariable class. However, there are some variations. For example, the "?" variable is a member of the QuestionMarkVariable class, and the "MaximumVariableCount" variable is a member of the SessionStateCapacityVariable class.
The Variable provider exposes its data store in the Variable: drive. To work with variables, you can change your location to the Variable: drive ("set-location variable:"), or you can work from any other Windows PowerShell drive. To reference a variable from another location, use the drive name (Variable:) in the path.
Windows PowerShell includes a set of cmdlets designed especially to view and to change variables:
-- Get-Variable
-- New-Variable
-- Set-Variable
-- Remove-Variable
-- Clear-Variable
When you use these cmdlets, you do not need to specify the Variable: drive in the name.
The Variable provider supports all of the cmdlets whose names contain the Item noun (the Item cmdlets), except for Invoke-Item. The Variable provider supports the Get-Content and Set-Content cmdlets. However, it does not support the cmdlets whose names contain the ItemProperty noun (the ItemProperty cmdlets), and it does not support the Filter parameter in any cmdlet.
You can also use the Windows PowerShell expression parser to create, view, and change the values of variables without using the cmdlets. When working with variables directly, use a dollar sign ($) to identify the name as a variable and the assignment operator (=) to establish and change its value. For example, "$p = Get-Process" creates the "p" variable and stores the results of a "Get-Process" command in it.
All changes to the variables affect the current session only. To save the changes, add the changes to the Windows PowerShell profile, or use Export-Console to save the current console.
CAPABILITIES
ShouldProcess
EXAMPLES
Getting to the Variable: Drive
-------------------------- EXAMPLE 1 --------------------------
This command changes the current location to the Variable: drive. You can use this command from any drive in Windows PowerShell. To return to a file system drive, type the drive name. For example, type "set-location c:".
Copy Code | |
---|---|
set-location variable: |
Displaying the Value of Variables
-------------------------- EXAMPLE 1 --------------------------
This command gets the list of all the variables and their values in the current session. You can use this command from any Windows PowerShell drive.
Copy Code | |
---|---|
get-childitem -path variable: |
-------------------------- EXAMPLE 2 --------------------------
This command gets the variables with names that begin with "max". You can use this command from any Windows PowerShell drive.
Copy Code | |
---|---|
get-childitem -path variable:max* |
If you are in the Variable: drive, you can omit the drive name from the path.
-------------------------- EXAMPLE 3 --------------------------
This command gets the value of the WhatIfPreference variable by typing it at the command line.
The name of the variable is preceded by a dollar sign ($) to indicate that it is a variable. The Variable: drive name is not specified.
Copy Code | |
---|---|
$WhatIfPreference |
-------------------------- EXAMPLE 4 --------------------------
This command uses the LiteralPath parameter of Get-ChildItem to get the value of the "?" variable from within the Variable: drive. Get-ChildItem does not attempt to resolve any wildcards in the values of the LiteralPath parameter.
Copy Code | |
---|---|
get-childitem -literalpath ? |
To display the value of a variable with a special character name without a cmdlet, type a dollar sign ($) and the variable name. For example, to display the value of the "?" variable, type "$?".
-------------------------- EXAMPLE 5 --------------------------
This command gets the variables that have the values of "ReadOnly" or "Constant" for their Options property.
Copy Code | |
---|---|
get-childitem -path variable: | where-object {$_.options -match "Constant" -or $_.options -match "ReadOnly"} | format-list -property name, value, options |
Creating a New Variable
-------------------------- EXAMPLE 1 --------------------------
This command creates the "services" variable and stores the results of a Get-Service command in it. Because the current location is in the Variable: drive, the value of the Path parameter is a dot (.), which represents the current location.
The parentheses around the Get-Service command ensure that the command is executed before the variable is created. Without the parentheses, the value of the new variable is a "Get-Service" string.
Copy Code | |
---|---|
new-item -path . -name services -value (Get-Service) |
If you are not in the variable: drive, include the Variable: drive name in the path.
-------------------------- EXAMPLE 2 --------------------------
This command creates a "services" variable and stores the result of a Get-Service command in it.
The command uses a dollar sign ($) to indicate a variable and the assignment operator (=) to assign the result of the Get-Service command to the newly created variable.
Copy Code | |
---|---|
$services = Get-Service |
To create a variable without a value, omit the assignment operator.
Displaying the Properties and Methods of Variables
-------------------------- EXAMPLE 1 --------------------------
This command uses the Get-Item cmdlet to get all variables. The pipeline operator (|) sends the results to the Get-Member cmdlet, which displays the methods and properties of the object.
Copy Code | |
---|---|
get-item -path variable:* | get-member |
When you pipe a collection of objects (such as the collection of variables in the Variable: drive) to Get-Member, Get-Member evaluates each object in the collection separately and returns information about each of the object types that it finds. To get information about the collection of objects in the Variable: drive, use the InputObject parameter of Get-Member. For example, "get-member -inputobject (get-item variable:*)". When you use InputObject, Get-Member evaluates the collection, not the objects in the collection.
-------------------------- EXAMPLE 2 --------------------------
This command lists the values of the properties of the "home" variable. It uses the Get-Item cmdlet to get an object that represents the "home" variable. The pipeline operator (|) sends the results to the Format-List command. The Format-List command uses the Property parameter with a wildcard character (*) to format and to display the values of all of the properties of the "home" variable.
Copy Code | |
---|---|
get-item variable:home | format-list -property * |
Changing the Properties of a Variable
-------------------------- EXAMPLE 1 --------------------------
This command uses the Rename-Item cmdlet to change the name of the "a" variable to "processes".
Copy Code | |
---|---|
rename-item -path variable:a -newname processes |
-------------------------- EXAMPLE 2 --------------------------
This command uses the Set-Item cmdlet to change the value of the ErrorActionPreference variable to "Stop".
Copy Code | |
---|---|
set-item -path variable:ErrorActionPreference -value Stop |
-------------------------- EXAMPLE 3 --------------------------
This command changes the value of the ErrorActionPreference variable to "Stop".
It uses a dollar sign ($) to indicate a variable and the assignment operator (=) to assign the value.
Copy Code | |
---|---|
$ErrorActionPreference = Stop |
Copying a Variable
-------------------------- EXAMPLE 1 --------------------------
This command uses the Copy-Item cmdlet to copy the "processes" variable to "old_processes". This creates a new variable named "old_processes" that has the same value as the "processes" variable.
Copy Code | |
---|---|
copy-item -path variable:processes -destination variable:old_processes |
If the command is issued from within the Variable: drive, you can omit the drive name from the value of the Path parameter.
-------------------------- EXAMPLE 2 --------------------------
This command copies the "processes" variable to "old_processes" without using a cmdlet. It uses the dollar sign ($) to indicate variables and the assignment operator to assign the value of $processes to old_processes.
Copy Code | |
---|---|
$old_processes = $processes |
Deleting a Variable
-------------------------- EXAMPLE 1 --------------------------
This command deletes the "serv" variable from the current session. You can use this command in any Windows PowerShell drive.
Copy Code | |
---|---|
remove-variable -path variable:serv |
-------------------------- EXAMPLE 2 --------------------------
This command deletes all variables from the current session except for the variables whose Options property has a value of Constant. Without the Force parameter, the command does not delete variables whose Options property has a value of ReadOnly.
Copy Code | |
---|---|
remove-item variable:* -force |
Setting the Value of a Variable to NULL
-------------------------- EXAMPLE 1 --------------------------
This command uses the Clear-Item cmdlet to change the value of the "processes" variable to NULL.
Copy Code | |
---|---|
clear-item -path variable:processes |
-------------------------- EXAMPLE 2 --------------------------
This command clears the value of the "processes" variable by assigning a null value to it. It uses the $null automatic variable to represent the NULL value.
Copy Code | |
---|---|
$processes = $null |