Get-Variable

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene las variables de la consola actual.

Syntax

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValueOnly

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.