Get-Variable
Obtiene las variables de la consola actual.
Sintaxis
Default (Es el valor predeterminado).
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 el valor de la variable según la 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 los caracteres comodín.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Include
Especifica una matriz de elementos en los que el cmdlet actuará, excepto todos los demás. Se permiten los caracteres comodín.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica el nombre de la variable.
Se permiten los caracteres comodín.
También puede redirigir un nombre de variable a Get-Variable.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Scope
Especifica las variables del ámbito. Los valores aceptables para este parámetro son:
- Global
- 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ValueOnly
Indica que este cmdlet obtiene solo el valor de la variable.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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 la colecció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 entorno.
