PowerShell : chemins des modules et mises à jour
Fonctionnement de PSModulePath, import de modules hors chemin, portées d'installation et mise à jour des modules.
Comment PowerShell trouve ses modules, où ils sont installés, comment importer un module absent du chemin des modules et comment maintenir à jour les modules installés.
Chemin de recherche des modules
PowerShell cherche les modules dans les répertoires listés dans la variable d'environnement PSModulePath, une liste séparée par des points-virgules (sous Windows). PowerShell 7 et Windows PowerShell 5.1 ont des listes différentes :
"PowerShell 7 paths:", ($env:PSModulePath -split ';')
"Windows PowerShell 5.1 paths:", (powershell -command "$env:PSModulePath -split ';'")
Emplacements habituels de Windows PowerShell :
| Portée | Chemin |
|---|---|
| Utilisateur courant | $env:UserProfile\Documents\WindowsPowerShell\Modules |
| Tous les utilisateurs | $env:ProgramFiles\WindowsPowerShell\Modules |
| Système | $env:SystemRoot\system32\WindowsPowerShell\v1.0\Modules |
Les modules de l'emplacement système sont livrés avec PowerShell et disponibles pour tout le système ; il ne faut pas les modifier. D'autres outils (par exemple SQL Server Management Studio, System Center Operations Manager ou Chef Development Kit) peuvent ajouter leurs propres chemins à PSModulePath.
Utiliser un module absent du chemin
Ajouter temporairement un répertoire à PSModulePath pour la session courante. TestModule doit être un sous-dossier de ce répertoire :
$env:PSModulePath += ';C:\Path\To\Temporary\ModuleDirectory'
Import-Module TestModule
La modification ne dure que le temps de la session. Pour que le module reste disponible en permanence, le copier dans l'un des répertoires de modules existants ou ajouter son répertoire parent à la variable d'environnement PSModulePath.
On peut aussi importer un module par son chemin :
# Must have a valid .psd1 manifest in the ModuleName folder
Import-Module C:\SomeFolder\ModuleName
# You can directly import .psm1 files, but don't do this if a module manifest is present
Import-Module C:\SomeFolder\OtherModules\SomeModule.psm1
Des chemins UNC (réseau) peuvent aussi être ajoutés à PSModulePath ; les scripts chargés depuis un emplacement distant restent soumis à la stratégie d'exécution du système.
Emplacement d'installation
Par défaut, Install-Module installe dans l'emplacement de l'utilisateur courant. Le paramètre -Scope permet de choisir entre les deux emplacements pris en charge :
# Current user (default when the scope is not specified)
Install-Module -Scope CurrentUser $moduleName
# All users (requires elevated permissions)
Install-Module -Scope AllUsers $moduleName
Un logiciel qui livre ses propres modules PowerShell devrait plutôt ajouter un répertoire dédié à PSModulePath que s'installer dans les emplacements gérés par l'utilisateur. Cela évite qu'un module soit modifié ou supprimé par erreur.
Voir la réponse Stack Overflow sur la manière dont PowerShell trouve les modules.
Mettre à jour les modules installés
Mettre à jour tous les modules installés depuis la PowerShell Gallery :
Get-InstalledModule | Update-Module
Signaler seulement les modules qui ont une version plus récente :
Get-InstalledModule | foreach { $b = (find-module $_.name).version ; if ($b -ne $_.version) { Write-host "$($_.name) has an update from $($_.version) to $b" } }
Mettre à jour les modules Azure* (sauf AzureRM) et supprimer l'ancienne version :
Get-Module -Name azure* -ListAvailable |
Where-Object -Property Name -ne 'AzureRM' |
ForEach-Object {
$currentVersion = [Version] $_.Version
$newVersion = [Version] (Find-Module -Name $_.Name).Version
if ($newVersion -gt $currentVersion) {
Write-Host -Object "Updating $_ Module from $currentVersion to $newVersion"
Update-Module -Name $_.Name -RequiredVersion $newVersion -Force
Uninstall-Module -Name $_.Name -RequiredVersion $currentVersion -Force
}
}
Problèmes d'installation
Si l'installation de modules échoue sur un système ancien, mettre à jour PowerShellGet et le fournisseur de paquets NuGet :
Install-Module –Name PowerShellGet –Force -AllowClobber
Install-PackageProvider Nuget -Force
Exemple d'installation pour l'utilisateur courant (VMware PowerCLI) :
Install-Module –Name VMware.PowerCLI –Scope CurrentUser –AllowClobber
Si la connexion à la PowerShell Gallery échoue, activer TLS 1.2, réenregistrer le dépôt par défaut et le marquer comme approuvé :
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Register-PSRepository -Default -Verbose
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Remarques
- Windows PowerShell 5.1 est livré avec Windows Management Framework 5.1, installable sur les systèmes plus anciens.
AzureRMest remplacé par les modulesAz.