Installation

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
Devolutions Forum logo Donnez-nous vos commentaires