Devolutions.PowerShell-Kernmodul

Das PowerShell-Modul muss nun aus der PowerShell Gallery heruntergeladen werden. Es ist nicht länger im Installationspaket von Remote Desktop Manager enthalten. Das bedeutet auch, dass Remote Desktop Manager nicht auf einem Computer installiert sein muss, um PowerShell-Skripte auszuführen: Das Modul genügt nun.

Um sich mit einer erweiterten Datenquelle zu verbinden, muss dem Konto, das für die Verbindung mit der Datenquelle verwendet wird, eine Remote Desktop Manager-Lizenz zugewiesen sein.

Installation

Ab Remote Desktop Manager 2023.1 ist PowerShell 7.2 oder höher für die Installation des Moduls erforderlich. Für Remote Desktop Manager-Versionen vor 2023.1 ist PowerShell 5.1 oder höher erforderlich.

PowerShell-Installation

Install-Module -Name Devolutions.PowerShell

Manuelle Installation

Auf einigen Computern kann es erforderlich sein, das Modul manuell zu installieren. Hier sind die Schritte, um diesen Vorgang abzuschließen:

1. Laden Sie die NUPKG-Datei des Devolutions.PowerShell-Moduls aus der PowerShell Gallery herunter. 1. Ändern Sie die Dateierweiterung auf .zip. 1. Extrahieren Sie die Datei nach C:\Program Files\WindowsPowerShell\Modules\devolutions.powershell\version. 1. Heben Sie die Blockierung aller neu extrahierten Dateien auf.

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

Migration Ihrer Skripte

Nach der Installation besteht die einzige erforderliche Änderung darin, den Befehl Import-Module aus den Skripten zu entfernen, die mit dem alten Remote Desktop Manager PowerShell-Modul verwendet wurden. Da das Modul nun Teil der auf dem Computer installierten PowerShell-Module ist, muss es nicht mehr in die Skripte importiert werden.

Eine Override-Konfiguration verwenden (portabel)

Mit den Cmdlets Get-RDMPowerShellOverride und Set-RDMPowerShellOverride ist es möglich, einen anderen Zielordner zum Speichern der Konfigurationsdateien zu wählen oder einen Ordner auszuwählen, der sich von dem standardmäßig durch das Modul Devolutions.PowerShell definierten unterscheidet. Diese Befehle können auch verwendet werden, um einen Ordner auszuwählen, der Dateien einer anderen als der Standardkonfiguration von Remote Desktop Manager enthält.

Beide Eigenschaften sind optional; wenn sie leer bleiben, werden ihre Standardwerte angewendet.

• OptionFilePath: der vollständige Pfad zur Datei RemoteDesktopManager.cfg

Standard: %LOCALAPPDATA%\Devolutions\RemoteDesktopManager

• RemoteDesktopManagerExecutablePath: für die Verwendung von Start-RDMSession oder Start-RDMProcess

Standard: %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

Grundlegende Fehlerbehebung

Manchmal kann es scheinen, dass mehrere Versionen des PowerShell-Moduls verwendet werden. Durch Eingabe von $env:PSModulePath können Sie zu diesen Speicherorten navigieren, um die Dateien RemoteDesktopManager und RemoteDesktopManager.PowershellModule zu löschen und eine Neuinstallation vorzunehmen (ein Umbenennen verhindert nicht, dass das System sie durchsucht und die darin enthaltenen Module findet).

$env:PSModulePath

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

PowerShell-Version und die verwendete Konfigurationsdatei abfragen

Get-RDMInstance

ApplicationVersion OptionFilename
------------------ --------------
2023.1.0.14 C:\RemoteDesktopManager\2023.1\config\RemoteDesktopManager.cfg