Modulo core Devolutions.PowerShell

Il modulo PowerShell ora deve essere scaricato dal PowerShell Gallery. Non è più incluso nel pacchetto di installazione di Remote Desktop Manager. Ciò significa anche che non è necessario installare Remote Desktop Manager su una macchina per eseguire script PowerShell: ora il modulo è sufficiente.

Per connettersi a uno spazio di lavoro avanzato, l'account utilizzato per connettersi allo spazio di lavoro deve avere una licenza di Remote Desktop Manager assegnata.

Installazione

A partire da Remote Desktop Manager 2023.1, per installare il modulo è richiesto PowerShell 7.2 o versione successiva. Per le versioni di Remote Desktop Manager precedenti alla 2023.1, è richiesto PowerShell 5.1 o versione successiva.

Installazione di PowerShell

Install-Module -Name Devolutions.PowerShell

Installazione manuale

Su alcune macchine, potrebbe essere necessario installare il modulo manualmente. Ecco i passaggi per completare questo processo:

1. Scarichi il file NUPKG del modulo Devolutions.PowerShell dal PowerShell Gallery. 1. Cambi l'estensione del file in .zip. 1. Estragga il file in C:\Program Files\WindowsPowerShell\Modules\devolutions.powershell\version. 1. Sblocchi tutti i file appena estratti.

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

Migrazione dei suoi script

Una volta installato, l'unica modifica necessaria è rimuovere il comando Import-Module dagli script utilizzati con il vecchio modulo PowerShell di Remote Desktop Manager. Poiché il modulo fa ora parte dei moduli PowerShell installati sul computer, non è più necessario importarlo negli script.

Utilizzare una configurazione di override (portatile)

Utilizzando i cmdlet Get-RDMPowerShellOverride e Set-RDMPowerShellOverride, è possibile scegliere un'altra cartella di destinazione in cui salvare i file di configurazione o selezionare una cartella diversa da quella definita per impostazione predefinita dal modulo Devolutions.PowerShell. Questi comandi possono essere utilizzati anche per selezionare una cartella contenente i file di una configurazione di Remote Desktop Manager esistente diversa da quella predefinita.

Entrambe le proprietà sono facoltative e i loro valori predefiniti vengono applicati se lasciate vuote.

• OptionFilePath: il percorso completo del file RemoteDesktopManager.cfg

Predefinito: %LOCALAPPDATA%\Devolutions\RemoteDesktopManager

• RemoteDesktopManagerExecutablePath: per l'uso di Start-RDMSession o Start-RDMProcess

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

Risoluzione dei problemi di base

A volte, può sembrare che siano in uso più versioni del modulo PowerShell. Digitando $env:PSModulePath, può quindi accedere a queste posizioni per eliminare i file RemoteDesktopManager e RemoteDesktopManager.PowershellModule ed effettuare una nuova installazione (rinominarli non impedisce al sistema di analizzarli e trovarvi i moduli).

$env:PSModulePath

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

Interrogare la versione di PowerShell e il file di configurazione in uso

Get-RDMInstance

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