Get-Variable
SYNOPSIS
Gets the variables in the current console.
SYNTAX
Get-Variable [[-name] <string[]>] [-include <string[]>] [-exclude <string[]>] [-valueOnly] [-scope <string>] [<CommonParameters>]
DETAILED DESCRIPTION
Gets the Windows PowerShell variables in the current console. You can retrieve just the values of the variables by specifying the ValueOnly parameter and you can filter the variables returned by name.
PARAMETERS
-name <string[]>
Specifies the name of the variable.
Required? |
false |
Position? |
1 |
Default value |
* (gets all variables in Variable:/) |
Accept pipeline input? |
true (ByValue, ByPropertyName) |
Accept wildcard characters? |
true |
-include <string[]>
Specifies only those items upon which the cmdlet will act, excluding all others. Wildcards are permitted.
Required? |
false |
Position? |
named |
Default value |
|
Accept pipeline input? |
false |
Accept wildcard characters? |
true |
-exclude <string[]>
Omits the specified items. Wildcards are permitted.
Required? |
false |
Position? |
named |
Default value |
|
Accept pipeline input? |
false |
Accept wildcard characters? |
true |
-valueOnly <SwitchParameter>
Gets only the value of the variable.
Required? |
false |
Position? |
named |
Default value |
False |
Accept pipeline input? |
false |
Accept wildcard characters? |
false |
-scope <string>
Limits the variables retrieved to the specified scope. The value can be a named scope: "global", "local", or "script", "private" or it can be a number relative to the current scope (0 through the number of scopes where 0 is the current scope and increasing the number by 1 moves to the parent scope of the current scope).
Required? |
false |
Position? |
named |
Default value |
Local |
Accept pipeline input? |
false |
Accept wildcard characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, type, "get-help about_commonparameters".
INPUT TYPE
Object
RETURN TYPE
Object
NOTES
This cmdlet does not manage environment variables. To manage environment variables, you can use the environment variable provider.
EXAMPLE 1
get-variable m*
This command displays variables with names that begin with the letter 'm'. The value of the variables is also displayed.
EXAMPLE 2
get-variable m* -valueonly
This command displays only the values of the variables with names that begin with the letter 'm'.
EXAMPLE 3
get-variable -include M*,P* | sort-object name
This command gets information about the variables that begin with either the letter 'M' or the letter 'P'. The results are piped to the Sort-Objectcmdlet, sorted by name and displayed.
RELATED LINKS