Get-Variable
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
Puede canalizar una cadena que contenga el nombre de la variable a este cmdlet.
Salidas
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.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de