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




Tabla de contenido