Créer des modules dans des scripts Windows PowerShell
Vous pouvez créer des modules pour stocker des fonctions et partager celles-ci entre les scripts. Une fois vos fonctions placées dans des modules, elles sont détectables tout comme de cmdlets. De même, comme les modules inclus avec Windows, les modules que vous créez se chargent automatiquement quand une fonction est requise.
Notes
En guise de meilleure pratique, vous devriez nommer vos fonctions dans les modules avec une structure de nommage similaire à la convention d’affectation des noms des cmdlets. Par exemple, utilisez le format verbe-substantif.
Notes
Les fonctions dans les modules peuvent inclure une aide basée sur des commentaires, détectable à l’aide de la cmdlet Get-Help. Pour cela, vous devez inclure les informations d’aide dans chaque fonction.
Dans de nombreux cas, vous disposez déjà de vos fonctions dans un fichier de script Windows PowerShell. Pour convertir en module un fichier de script contenant uniquement des fonctions, renommez-le avec l’extension de fichier .psm1. Aucune modification structurelle n’est requise dans le fichier.
Windows PowerShell utilise la variable d’environnement $PSModulePath pour définir les chemins d’accès à partir desquels les modules sont chargés. Les chemins d’accès répertoriés dans Windows PowerShell 5.0 sont les suivants :
- C :\Users\UserID\Documents\WindowsPowerShell\Modules
- C :\Program Files\WindowsPowerShell\Modules
- C :\Windows\System32\WindowsPowerShell\1.0\Modules
Windows PowerShell 7 inclut les autres chemins d’accès suivants :
- C :\Program Files\PowerShell\Modules
- C :\Program Files\PowerShell\7\Modules
Notes
Si vous stockez des modules dans C:\Users\UserID\Document\WindowsPowerShell\Modules, ils ne sont disponibles que pour un seul utilisateur.
Les modules ne sont pas placés directement dans le répertoire Modules. Au lieu de cela, vous devez créer un sous-dossier portant le même nom que le fichier et placer le fichier dans ce dossier. Par exemple, si vous avez un module nommé AdatumFunctions.psm1, vous devez le placer dans C:\Program Files\WindowsPowerShell\Modules\AdatumFunctions.