Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Descripción breve
En este artículo se describe el propósito y el uso de la variable de entorno $env:PSModulePath.
Descripción larga
La variable de entorno $env:PSModulePath contiene una lista de ubicaciones de carpetas que se buscan para buscar módulos y recursos. PowerShell busca recursivamente cada carpeta para los archivos de módulo (.psd1 o .psm1).
Install-Module tiene un parámetro Scope que permite especificar si el módulo está instalado para el usuario actual o para todos los usuarios. Para obtener más información, vea Install-Module.
De forma predeterminada, las ubicaciones efectivas asignadas a $env:PSModulePath son:
Ubicaciones de todo el sistema: estas carpetas contienen módulos que se incluyen con PowerShell. Estos módulos se almacenan en la
$PSHOME\Modulescarpeta.- En Windows, los módulos instalados en el ámbito AllUsers se almacenan en
$env:ProgramFiles\WindowsPowerShell\Modulesarchivos . - En sistemas que no son Windows, los módulos instalados en el ámbito AllUsers se almacenan en
/usr/local/share/powershell/Modules.
- En Windows, los módulos instalados en el ámbito AllUsers se almacenan en
Módulos instalados por el usuario: en Windows, los módulos instalados en el ámbito CurrentUser normalmente se almacenan en la
$HOME\Documents\WindowsPowerShell\Modulescarpeta. La ubicación específica de la carpetaDocumentsvaría según la versión de Windows y cuando se usa el redireccionamiento de carpetas. Además, Microsoft OneDrive puede cambiar la ubicación de la carpetaDocuments. Puede verificar la ubicación de suDocumentscarpeta mediante el siguiente comando:[Environment]::GetFolderPath('MyDocuments').En sistemas que no son Windows, los módulos instalados en el ámbito CurrentUser se almacenan en la
$HOME/.local/share/powershell/Modulescarpeta.Módulos específicos de la aplicación: Los programas de instalación pueden instalar módulos en otros directorios, como la
Program Filescarpeta de Windows. El paquete del instalador puede o no anexar la ubicación al$env:PSModulePatharchivo .
Construcción de PSModulePath de PowerShell
El valor de $env:PSModulePath se construye cada vez que se inicia PowerShell.
El valor varía según la versión de PowerShell y cómo se inicia.
Inicio de Windows PowerShell
Windows PowerShell usa la siguiente lógica para construir el PSModulePath en el inicio:
- Si no existe
PSModulePath, combine currentUser, AllUsersy las rutas de acceso de los módulos de$PSHOME - Si
PSModulePathexiste:- Si
PSModulePathcontiene$PSHOMEruta de acceso de módulos:-
ruta de acceso de los módulos AllUsers se inserta antes de
$PSHOMEruta de acceso de los módulos
-
ruta de acceso de los módulos AllUsers se inserta antes de
- más:
- Solo tiene que usar
PSModulePathtal como se define, ya que el usuario quitó deliberadamente la ubicación de$PSHOME
- Solo tiene que usar
- Si
La ruta de acceso del módulo CurrentUser solo tiene el prefijo si el ámbito de usuario $env:PSModulePath no existe. De lo contrario, el ámbito de usuario $env:PSModulePath se usa como se define.
Inicio de PowerShell 7
En Windows, para la mayoría de las variables de entorno, si existe la variable de ámbito de usuario, un nuevo proceso usa ese valor solo aunque exista una variable con ámbito de máquina con el mismo nombre.
En PowerShell 7, PSModulePath se trata de forma similar a cómo se trata la variable de Path entorno en Windows. En Windows, Path se trata de forma diferente a otras variables de entorno. Cuando se inicia un proceso, Windows combina el Path de ámbito de usuario con el ámbito de máquina Path.
- Recuperar el
PSModulePathde ámbito de usuario - Comparación con el proceso heredado
PSModulePathvariable de entorno- Si es lo mismo:
- Anexe el AllUsers
PSModulePathal final siguiendo la semántica de la variable de entornoPath - La ruta de acceso de Windows
System32proviene de la máquina definida,PSModulePathpor lo que no es necesario agregarla explícitamente
- Anexe el AllUsers
- Si es diferente, trate como si el usuario lo modificara explícitamente y no anexe AllUsers
PSModulePath
- Si es lo mismo:
- Prefijo con las rutas de acceso usuario, sistema y
$PSHOMEps7 en ese orden- Si
powershell.config.jsoncontiene unPSModulePathde ámbito de usuario, úselo en lugar del valor predeterminado para el usuario. - Si
powershell.config.jsoncontiene unPSModulePathde ámbito del sistema , úselo en lugar del valor predeterminado para el sistema.
- Si
Los sistemas Unix no tienen una separación de variables de entorno de usuario y sistema.
PSModulePath se hereda y las rutas de acceso específicas de PS7 tienen el prefijo si aún no están definidos.
Inicio de Windows PowerShell desde PowerShell 7
Para esta explicación, windows PowerShell significa tanto powershell.exe como powershell_ise.exe.
El valor de $env:PSModulePath se copia en WinPSModulePath con las siguientes modificaciones:
- Eliminación de PS7 en la ruta de acceso del módulo de usuario
- Eliminación de PS7 en la ruta de acceso del módulo del sistema
- Eliminación de PS7 en la ruta de acceso del módulo de
$PSHOME
Las rutas de acceso de PS7 se quitan para que los módulos PS7 no se carguen en Windows PowerShell. El valor WinPSModulePath se usa al iniciar Windows PowerShell.
Inicio de PowerShell 7 desde Windows PowerShell
El inicio de PowerShell 7 continúa as-is con la adición de rutas de acceso heredadas que agregó Windows PowerShell. Dado que las rutas de acceso específicas de PS7 tienen el prefijo , no hay ningún problema funcional.
Comportamiento de búsqueda de módulos
PowerShell busca recursivamente cada carpeta en los archivos de PSModulePath para los archivos de módulo (.psd1 o .psm1). Este patrón de búsqueda permite instalar varias versiones del mismo módulo en carpetas diferentes. Por ejemplo:
Directory: C:\Program Files\WindowsPowerShell\Modules\PowerShellGet
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 8/14/2020 5:56 PM 1.0.0.1
d---- 9/13/2019 3:53 PM 2.1.2
De forma predeterminada, PowerShell carga el número de versión más alto de un módulo cuando se encuentran varias versiones. Para cargar una versión específica, use Import-Module con el parámetro FullyQualifiedName. Para obtener más información, vea Import-Module.
Modificación de PSModulePath
En la mayoría de las situaciones, debe instalar módulos en las ubicaciones predeterminadas del módulo. Sin embargo, es posible que tenga que cambiar el valor de la PSModulePath variable de entorno.
Por ejemplo, para agregar temporalmente el directorio C:\Program Files\Fabrikam\Modules a $env:PSModulePath para la sesión actual, escriba:
$Env:PSModulePath = $Env:PSModulePath+";C:\Program Files\Fabrikam\Modules"
El punto y coma (;) del comando separa la nueva ruta de acceso de la ruta de acceso que la precede en la lista. En plataformas que no son de Windows, los dos puntos (:) separan las ubicaciones de ruta de acceso en la variable de entorno.
Modificación de PSModulePath en elementos que no son de Windows
Para cambiar el valor de PSModulePath para cada sesión en un entorno que no es de Windows, agregue el comando anterior al perfil de PowerShell.
Modificación de PSModulePath en Windows
Para cambiar el valor de PSModulePath en cada sesión, edite la clave del Registro que almacena los valores de PSModulePath. Los valores de PSModulePath se almacenan en el Registro como cadenas no expandidas. Para evitar guardar permanentemente los PSModulePath valores como cadenas expandidas , use el método GetValue en la subclave y edite el valor directamente.
En el ejemplo siguiente se agrega la C:\Program Files\Fabrikam\Modules ruta de acceso al valor de la PSModulePath variable de entorno sin expandir las cadenas no expandidas.
$key = (Get-Item 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager').OpenSubKey('Environment', $true)
$path = $key.GetValue('PSModulePath','','DoNotExpandEnvironmentNames')
$path += ';%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)
Para agregar una ruta de acceso a la configuración de usuario, cambie el proveedor del Registro de HKLM:\ a HKCU:\.
$key = (Get-Item 'HKCU:\').OpenSubKey('Environment', $true)
$path = $key.GetValue('PSModulePath','','DoNotExpandEnvironmentNames')
$path += ';%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)