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 cmdlet Get-Variable 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 definidas en el ámbito local. Es equivalente a Get-Variable -Scope Local y se puede abreviar como gv -s 0.

El segundo comando usa el cmdlet Compare-Object 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 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 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 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:

  • global
  • local
  • script de
  • 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, vea 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[]

Al especificar 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 comando Get-Variable entre paréntesis.

Notas

PowerShell incluye los siguientes alias para Get-Variable:

  • Todas las plataformas:

    • gv

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