Le module PowerShell doit maintenant être téléchargé depuis la PowerShell Gallery. Il n'est plus inclus dans le paquet d'installation de Remote Desktop Manager. Cela signifie également qu'il n'est pas nécessaire d'installer Remote Desktop Manager sur une machine pour exécuter des scripts PowerShell : le module est maintenant suffisant.
Pour se connecter à une source de données avancée, le compte utilisé pour se connecter à la source de données doit avoir une licence Remote Desktop Manager attribuée. L'utilisation d'une clé d'application avec une source de données Devolutions Server ne nécessite pas de licence.
À partir de Remote Desktop Manager 2023.1, PowerShell 7.2 ou ultérieure est requis pour installer le module. Pour les versions antérieures de Remote Desktop Manager à 2023.1, PowerShell 5.1 ou ultérieure est requis.
Install-Module -Name Devolutions.PowerShell
Sur certaines machines, il peut être nécessaire d'installer manuellement le module PowerShell. Voici les étapes pour compléter ce processus :
1. Télécharger le fichier NUPKG du module Devolutions.PowerShell depuis la PowerShell Gallery. 1. Changer l'extension du fichier en .zip. 1. Extraire le fichier dans C:\Program Files\WindowsPowerShell\Modules\devolutions.powershell\version. 1. Débloquer tous les fichiers nouvellement extraits.
cd c:\program files\WindowsPowerShell\modules\devolutions.powershell\<version>
dir * | unblock-file -verbose
Une fois installé, la seule modification requise est de supprimer 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.
En utilisant les cmdlets Get-RDMPowerShellOverride et Set-RDMPowerShellOverride, il est possible de choisir un autre dossier de destination pour enregistrer les fichiers de configuration ou de sélectionner un dossier différent de celui défini par défaut par le module Devolutions.PowerShell. Ces commandes peuvent également être utilisées pour sélectionner un dossier contenant des fichiers d'une configuration existante de Remote Desktop Manager différente de celle par défaut.
Les deux propriétés sont facultatives, et leurs valeurs par défaut sont appliquées lorsqu'elles sont laissées vides.
OptionFilePath : le chemin complet vers le fichier RemoteDesktopManager.cfg
Par défaut : %LOCALAPPDATA%\Devolutions\RemoteDesktopManager
RemoteDesktopManagerExecutablePath : pour l'utilisation de
Start-RDMSessionouStart-RDMProcess
Par défaut : %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
Parfois, plusieurs versions du module PowerShell peuvent sembler être en cours d'utilisation. En tapant $env:PSModulePath, vous pouvez ensuite parcourir ces emplacements pour supprimer les fichiers RemoteDesktopManager et RemoteDesktopManager.PowershellModule pour réinstaller à neuf (renommer ne permet pas au système de scanner et de trouver les modules).
$env:PSModulePath
C:\Users\admin\Documents\WindowsPowerShell\Modules;
C:\Program Files\WindowsPowerShell\Modules;
C:\windows\system32\WindowsPowerShell\v1.0\Modules
Get-RDMInstance
ApplicationVersion OptionFilename
------------------ --------------
2023.1.0.14 C:\RemoteDesktopManager\2023.1\config\RemoteDesktopManager.cfg
Donnez-nous vos commentaires