Module de base Devolutions.PowerShell

Le module PowerShell doit maintenant être téléchargé à partir de la PowerShell Gallery. En effet, le module n’est plus inclus dans le paquet d’installation de Remote Desktop Manager. Il n’est donc plus nécessaire d’installer Remote Desktop Manager pour exécuter des scripts PowerShell : le module suffit.

Installation

Installation à partir de PowerShell

• Remote Desktop Manager versions 2023.1 et ultérieures : Install-Module -Name Devolutions.PowerShell
• Remote Desktop Manager versions antérieures à 2023.1 : Install-Module -Name RemoteDesktopManager

Installation manuelle

Sur certains ordinateurs, il peut être nécessaire d'installer manuellement le module PowerShell. Voici les étapes à suivre :

• Remote Desktop Manager versions 2023.1 et ultérieures :
  1. Télécharger le fichier NUPKG du module Devolutions.PowerShell depuis la PowerShell Gallery.
  2. Changer l'extension du fichier en .zip.
  3. Extraire dans C:\Program Files\WindowsPowerShell\Modules\remotedesktopmanager\version.
  4. Débloquer tous les fichiers nouvellement extraits.

  cd c:\program files\WindowsPowerShell\modules\devolutions.powershell\<version>
  dir * | unblock-file -verbose
  

• Remote Desktop Manager versions antérieures à 2023.1 :
  1. Télécharger le fichier NUPKG du module RemoteDesktopManager depuis la PowerShell Gallery.
  2. Changer l'extension du fichier en .zip.
  3. Extraire dans C:\Program Files\WindowsPowerShell\Modules\remotedesktopmanager\version.
  4. Débloquer tous les fichiers nouvellement extraits.

  cd c:\program files\WindowsPowerShell\modules\remotedesktopmanager\<version>
  dir * | unblock-file -verbose
  

Migration de vos scripts

Une fois l’installation complétée, la seule action nécessaire est de retirer la commande Import-Module des scripts utilisés avec l’ancien module PowerShell de Remote Desktop Manager. Comme le module fait désormais partie des modules PowerShell installés sur l'ordinateur, il n'est plus nécessaire de l'importer dans les scripts.

Écraser avec une autre configuration (portable)

En utilisant les commandes Get-RDMPowerShellOverride et Set-RDMPowerShellOverride dans l’applet de commande, il est possible de choisir un autre dossier de destination pour sauvegarder les fichiers de configuration ou pour sélectionner un dossier différent de celui définit par défaut par le module Devolutions.PowerShell. Ces commandes peuvent aussi être utilisées pour sélectionner un dossier contenant les fichiers d'une configuration de Remote Desktop Manager existante autre que celle par défaut.

Les deux propriétés sont optionnelles et leurs valeurs par défaut seront appliquées si elles demeurent vides.

• OptionFilePath : le chemin complet vers le fichier RemoteDesktopManager.cfg

Default: %LOCALAPPDATA%\Devolutions\RemoteDesktopManager

• RemoteDesktopManagerExecutablePath : pour utiliser Start-RDMSession ou Start-RDMProcess

Default: %ProgramFiles%\Devolutions\Remote Desktop Manager\RemoteDesktopManager.exe

$override = Get-RDMPowerShellOverride
$override.OptionFilePath = "PathToCfg" # C:\RemoteDesktopManager\2023.1\config\RemoteDesktopManager.cfg
$override.RemoteDesktopManagerExecutablePath = "Path to desired Remote Desktop Manager version" # C:\RemoteDesktopManager\2023.1\Devolutions.RemoteDesktopManager.Bin.2023.1.11.0\RemoteDesktopManager64.exe
Set-RDMPowerShellOverride
# Restart Powershell

Dépannage de base

Il peut parfois sembler que plusieurs versions du module PowerShell soient en cours d’utilisation en même temps. En saisissant $env:PSModulePath, vous pouvez ensuite naviguer jusqu'à ces emplacements pour supprimer les fichiers RemoteDesktopManager et RemoteDesktopManager.PowershellModule afin de procéder à une nouvelle installation (renommer les fichiers n’empêche pas le système de les analyser et d’y trouver les modules qu'ils contiennent).

$env:PSModulePath  
  
C:\Users\admin\Documents\WindowsPowerShell\Modules;
C:\Program Files\WindowsPowerShell\Modules;
C:\windows\system32\WindowsPowerShell\v1.0\Modules

Interroger la version du PowerShell et le fichier de configuration en cours d'utilisation

Get-RDMInstance
PS C:\RemoteDesktopManager\2023.1\Devolutions.RemoteDesktopManager.Bin.2023.1.11.0> Get-RDMInstance
ApplicationVersion OptionFilename
2023.1.0.14 C:\RemoteDesktopManager\2023.1\config\RemoteDesktopManager.cfg