Creación de módulos en scripts de Windows PowerShell
Puede crear módulos para almacenar funciones y compartir esas funciones entre scripts. Después de colocar las funciones en módulos, se pueden detectar igual que los cmdlets. Además, al igual que los módulos incluidos con Windows, los módulos que se crean se cargan automáticamente cuando se requiere una función.
Nota:
Como procedimiento recomendado, debe nombrar las funciones de los módulos con una estructura de nomenclatura similar a la convención de nomenclatura de los cmdlets. Por ejemplo, usaría el formato verbo-sustantivo.
Nota:
Las funciones de los módulos pueden incluir ayuda basada en comentarios que se puede encontrar mediante Get-Help. Para admitir esto, debe incluir la información de ayuda en cada función.
En muchos casos, ya tiene las funciones en un archivo de script de Windows PowerShell. Para convertir un archivo de script que contenga solo funciones en un módulo, cámbielo por la extensión de archivo .psm1. No se requieren cambios estructurales en el archivo.
Windows PowerShell usa la variable de entorno $PSModulePath para definir las rutas de acceso desde las que se cargan los módulos. En Windows PowerShell 5.0, se enumeran las siguientes rutas de acceso:
- C:\Users\UserID\Documents\WindowsPowerShell\Modules
- C:\Archivos de programa\WindowsPowerShell\Modules
- C:\Windows\System32\WindowsPowerShell\1.0\Modules
Windows PowerShell 7 incluye las siguientes otras rutas de acceso:
- C:\Archivos de programa\PowerShell\Modules
- C:\Archivos de programa\PowerShell\7\Modules
Nota:
Si almacena módulos en C:\Users\UserID\Document\WindowsPowerShell\Modules, solo están disponibles para un solo usuario.
Los módulos no se colocan directamente en el directorio Modules. En su lugar, debe crear una subcarpeta con el mismo nombre que el archivo y colocar el archivo en esa carpeta. Por ejemplo, si tiene un módulo denominado AdatumFunctions.psm1, lo colocaría en C:\Program Files\WindowsPowerShell\Modules\AdatumFunctions.