Obtiene las variables de la consola actual.
Sintaxis
Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]
Descripción
El cmdlet Get-Variable obtiene las variables de Windows PowerShell en la consola actual. Puede recuperar los valores de las variables especificando el parámetro ValueOnly y filtrar las variables devueltas por nombre.
Parámetros
-Exclude <string[]>
Omite los elementos especificados. Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Especifica únicamente los elementos sobre los que actuará el cmdlet y excluye a todos los demás. Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica el nombre de la variable.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Scope <string>
Obtiene únicamente las variables del ámbito especificado. Los valores válidos son "Global", "Local", "Script" o el número correspondiente al ámbito actual (entre 0 y el número de ámbitos, donde 0 es el ámbito actual y 1 su ámbito principal). "Local" es el valor predeterminado. Para obtener más información, vea about_Scopes.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-ValueOnly
Obtiene únicamente el valor de la variable.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.String Puede canalizar a Get-Variable una cadena que contiene el nombre de la variable. |
|
Salidas |
Objeto de variable Get-Variable devuelve un objeto de variable de System.Management.Automation para cada variable que obtiene. El tipo de objeto depende de la variable. |
Notas
Este cmdlet no administra variables de entorno. Para administrar variables de entorno, puede usar el proveedor de variables de entorno.
Ejemplo 1
C:\PS>get-variable m* Descripción ----------- Este comando muestra las variables cuyo nombre comienza por la letra "m". También se muestra el valor de las variables.
Ejemplo 2
C:\PS>get-variable m* -valueonly Descripción ----------- Este comando muestra únicamente los valores de las variables cuyo nombre comienza por la letra "m".
Ejemplo 3
C:\PS>get-variable -include M*,P* | sort-object name Descripción ----------- Este comando obtiene información sobre las variables cuyo nombre comienza por la letra "M" o "P". Los resultados se canalizan al cmdlet Sort-Object, se ordenan por nombre y se muestran.
Ejemplo 4
C:\PS>get-variable -scope 0 C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1) Descripción ----------- El primer comando obtiene solo las variables definidas en el ámbito local. Equivale a "get-variable -scope local" y puede abreviarse como "gv -s 0". El segundo comando usa el cmdlet Compare-Object para obtener las variables que están definidas en el ámbito principal (Scope 1) pero que se pueden ver únicamente en el ámbito local (Scope 0).
Vea también