Las variables de entorno son la forma estándar de configurar un programa sin tocar su código: la carpeta del usuario, el idioma, la dirección de una API o un token. En PowerShell se leen y se cambian con $env:, y con un par de trucos tus scripts se adaptan solos a cada computadora.
También te puede interesar
Leer: $env:
$env:HOME $env:LANG "Variables definidas: $((Get-ChildItem Env:).Count)" Get-ChildItem Env:LANG, Env:TZ | Format-Table Name, Value $null -eq $env:NO_EXISTE
salida/home/ana es_MX.UTF-8 Variables definidas: 12 Name Value ---- ----- LANG es_MX.UTF-8 TZ America/Mexico_City True
Las variables de entorno se leen con el prefijo $env:, y la unidad Env: las lista todas. Una que no existe vale $null, sin error. Como el curso se ejecutó en Linux, aparecen HOME y LANG; en Windows, las más útiles son $env:USERPROFILE (tu carpeta, como C:\Users\ana), $env:APPDATA, $env:TEMP, $env:COMPUTERNAME y $env:USERNAME.
Configurar un script desde fuera
$puerto = if ($env:APP_PUERTO) { [int]$env:APP_PUERTO } else { 8080 }
$modo = $env:APP_MODO ?? "produccion"
"Puerto: $puerto, modo: $modo"sin variablesPuerto: 8080, modo: produccion
con APP_PUERTO=9000 y APP_MODO=pruebasPuerto: 9000, modo: pruebas
El operador ?? (PowerShell 7) devuelve el valor de la izquierda si no es $null, y si no, el de la derecha: es la forma corta de dar un valor por omisión. Así el mismo script sirve en tu computadora y en el servidor, cambiando solo el entorno.
Cambiar una variable: solo para esta sesión
$env:APP_MODO = "depuracion" "En este script: $env:APP_MODO" pwsh -NoProfile -Command '"Un programa lanzado desde aquí la hereda: $env:APP_MODO"' Remove-Item Env:APP_MODO "Después de borrarla: [$env:APP_MODO]"
salidaEn este script: depuracion Un programa lanzado desde aquí la hereda: depuracion Después de borrarla: []
Asignar a $env: cambia la variable para esta sesión de PowerShell y para los programas que lance; al cerrar la ventana, desaparece. Para quitarla antes, Remove-Item Env:NOMBRE.
Solo en Windows
Para que una variable quede guardada para siempre en tu usuario de Windows (como en Configuración, «Editar las variables de entorno»), se usa el método de .NET con el ámbito User:
[Environment]::SetEnvironmentVariable("APP_MODO", "pruebas", "User")
[Environment]::GetEnvironmentVariable("APP_MODO", "User")Las ventanas que ya estaban abiertas no se enteran: hay que abrir una nueva. Con el ámbito Machine afecta a todos los usuarios y necesita permisos de administrador. En Linux y macOS este método no guarda nada de forma permanente; allí se usa el perfil de la shell. No pudimos ejecutarlo en el contenedor Linux del curso.
Un archivo .env
Muchos proyectos guardan la configuración local en un archivo .env que no se sube al repositorio. PowerShell no lo lee solo, pero son pocas líneas:
foreach ($linea in Get-Content -Path .env) {
if ($linea -match '^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$') {
Set-Item -Path "Env:$($Matches[1])" -Value $Matches[2]
}
}
"URL: $env:API_URL"
"Reintentos: $([int]$env:REINTENTOS + 0)"
"Token cargado: $(-not [string]::IsNullOrEmpty($env:API_TOKEN))"salidaURL: https://api.example.com Reintentos: 3 Token cargado: True
La expresión regular toma las líneas NOMBRE=valor e ignora los comentarios y las vacías. Fíjate en que el script no escribe el token, solo comprueba que se cargó: un valor secreto no debe aparecer en la pantalla ni en los registros.
Las variables de entorno siempre son texto. Si guardas un número, conviértelo con [int] antes de usarlo, por la misma razón que en el CSV: "3" + 1 da 31.
Todos los scripts de esta página se ejecutaron con PowerShell 7.6.10 (LTS) en un contenedor Linux limpio sin acceso a la red, con la configuración regional de México, y pasaron PSScriptAnalyzer 1.25 sin avisos antes de publicarla; las salidas están copiadas de esa ejecución. Por eso las rutas salen como /home/ana/proyecto; en Windows verás algo como C:\Users\ana.