Prérequis
Le module Devolutions.PowerShell nécessite PowerShell 7.4 ou supérieur, et prend en charge Windows, macOS et Linux. Windows PowerShell ou les versions antérieures de PowerShell 7 ne sont pas pris en charge car le module PowerShell est construit à partir du même noyau que Remote Desktop Manager, et nécessite donc une version de PowerShell utilisant une version compatible du runtime .NET (.NET 8).
PSGallery
Le module Devolutions.PowerShell est disponible dans PSGallery et il s'agit de la méthode d'installation par défaut recommandée :
Install-Module Devolutions.PowerShell -Force
Puisque PSGallery est généralement un dépôt marqué comme non fiable (les paquets ne sont pas organisés ou examinés), utiliser -Force
est nécessaire pour éviter d'obtenir la demande de confirmation.
Cloudsmith
PSGallery est idéal pour découvrir des paquets, mais il n'y a aucun moyen de marquer des paquets spécifiques comme fiables sans marquer l'ensemble du dépôt comme fiable. PSGallery a également connu des interruptions suffisamment longues pour devenir problématiques par le passé, nous proposons donc maintenant un dépôt Devolutions PowerShell hébergé par Cloudsmith.
Enregistrer le dépôt Devolutions PowerShell, qui peut être marqué comme fiable :
Register-PSRepository -Name 'Devolutions' -SourceLocation 'https://nuget.cloudsmith.io/devolutions/powershell/v2/' -InstallationPolicy Trusted
Désinstaller les versions précédentes du module Devolutions.PowerShell installées depuis PSGallery :
Uninstall-Module Devolutions.PowerShell -AllVersions
Installer explicitement le module Devolutions.PowerShell depuis le dépôt "Devolutions":
Install-Module Devolutions.PowerShell -Repository Devolutions
Puisque Devolutions.PowerShell est maintenant disponible dans plus d'un dépôt enregistré, le paramètre -Repository
devient obligatoire. Cependant, si vous avez marqué le dépôt "Devolutions" comme fiable, -Force
n'est pas nécessaire pour éviter la demande de confirmation.
Confirmer que le dépôt source d'installation pour le module Devolutions.PowerShell est "Devolutions" et non "PSGallery":
Get-InstalledModule Devolutions.PowerShell | Select-Object -Property Name, Repository
Name Repository
---- ----------
Devolutions.PowerShell Devolutions
Hors ligne
Que faire si vous devez installer le module Devolutions.PowerShell à partir d'une machine ayant un accès limité ou inexistant à Internet ? Les modules PowerShell ne peuvent être installés facilement qu'à partir d'un dépôt, mais heureusement, des dépôts simples basés sur des fichiers peuvent être utilisés. Créer un nouveau dépôt PowerShell appelé 'local' dans un répertoire de votre choix (comme "C:\psrepo") :
$RepoPath = "C:\psrepo"
New-Item -Path $RepoPath -ItemType 'Directory' -Force | Out-Null
Register-PSRepository -Name 'local' -SourceLocation $RepoPath -PublishLocation $RepoPath -InstallationPolicy Trusted
Il est possible d'utiliser un répertoire sur un partage réseau au lieu d'un répertoire local, facilitant ainsi la distribution du module PowerShell sur un réseau local.
Ensuite, prendre le fichier .nupkg brut pour le module Devolutions.PowerShell en utilisant le bouton Télécharger le fichier nupkg brut sous Téléchargement Manuel dans PSGallery. Copier le fichier .nupkg dans le répertoire de dépôt local PowerShell ("C:\psrepo").
Désinstaller les versions précédentes du module Devolutions.PowerShell installées à partir d'autres sources :
Uninstall-Module Devolutions.PowerShell -AllVersions
Installer le module Devolutions.PowerShell explicitement à partir du dépôt "local" :
Install-Module Devolutions.PowerShell -Repository local
Confirmer que la source d'installation pour le module Devolutions.PowerShell est "local":
Get-InstalledModule Devolutions.PowerShell | Select-Object -Property Name, Repository
Name Repository
---- ----------
Devolutions.PowerShell local
Nettoyer
Si vous avez essayé les différentes méthodes d'installation documentées ici, vous voudrez peut-être restaurer les choses dans un état propre avant de recommencer à zéro.
Désinstaller toutes les versions du module Devolutions.PowerShell :
Uninstall-Module Devolutions.PowerShell -AllVersions
Désenregistrer le dépôt cloudsmith "Devolutions":
Unregister-PSRepository Devolutions
Désenregistrer le dépôt basé sur fichier "local", et supprimer le répertoire associé :
Unregister-PSRepository local
Remove-Item "C:\psrepo" -Recurse -ErrorAction SilentlyContinue