Compartir a través de

Get-Variable

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene las variables de la consola actual.

Sintaxis

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Description

El Get-Variable cmdlet obtiene las variables de PowerShell en la consola actual. Puede recuperar solo los valores de las variables especificando el parámetro ValueOnly y puede filtrar las variables devueltas por nombre.

Ejemplos

Ejemplo 1: Obtener variables por letra

Este comando obtiene variables con nombres que comienzan por la letra m. El comando también obtiene el valor de las variables.

Get-Variable m*

Ejemplo 2: Obtener valores de variable por letra

Este comando obtiene solo los valores de las variables que tienen nombres que comienzan por m.

Get-Variable m* -ValueOnly

Ejemplo 3: Obtener variables por dos letras

Este comando obtiene información sobre las variables que comienzan por la letra M o la letra P.

Get-Variable -Include M*,P*

Ejemplo 4: Obtener variables por ámbito

El primer comando obtiene solo las variables que se definen en el ámbito local. Es equivalente a Get-Variable -Scope Local y se puede abreviar como gv -s 0.

El segundo comando usa el Compare-Object cmdlet para buscar las variables definidas en el ámbito primario (Ámbito 1), pero solo están visibles en el ámbito local (Ámbito 0).

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Parámetros

-Exclude

Especifica una matriz de elementos que este cmdlet excluye de la operación. Se permiten los caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Include

Especifica una matriz de elementos en los que el cmdlet actuará, excepto todos los demás. Se permiten los caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Name

Especifica el nombre de la variable. Se permiten los caracteres comodín. También puede canalizar un nombre de variable a Get-Variable.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Scope

Especifica las variables del ámbito. Los valores aceptables para este parámetro son:

  • Operaciones
  • Local
  • Script
  • Número relativo al ámbito actual (de 0 al número de ámbitos, donde 0 es el ámbito actual y 1 es su elemento primario).

Local es el valor predeterminado. Para obtener más información, consulte about_Scopes.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ValueOnly

Indica que este cmdlet obtiene solo el valor de la variable.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contenga el nombre de la variable a este cmdlet.

Salidas

PSVariable

De forma predeterminada, este cmdlet devuelve un objeto AutomationPSVariable para cada variable que obtiene. El tipo de objeto depende de la variable.

Object[]

Cuando se especifica el parámetro ValueOnly y el valor de la variable especificada es una colección, este cmdlet devuelve un [System.Object[]]. Este comportamiento impide que la operación de canalización normal procese los valores de la variable de uno en uno. Una solución alternativa para forzar la enumeración de recopilación es incluir el Get-Variable comando entre paréntesis.

Notas

PowerShell incluye los siguientes alias para Get-Variable:

  • Todas las plataformas:

    • gv

  • Este cmdlet no administra variables de entorno. Para administrar variables de entorno se puede usar el proveedor de variables de entorno.