Módulo principal Devolutions.PowerShell

Ahora el módulo de PowerShell debe descargarse desde PowerShell Gallery. Ya no se incluye en el paquete de instalación de Remote Desktop Manager. Esto también significa que no es necesario instalar Remote Desktop Manager en una máquina para ejecutar scripts de PowerShell: ahora el módulo es suficiente.

Para conectarse a un espacio de trabajo avanzado, la cuenta utilizada para conectarse al espacio de trabajo debe tener asignada una licencia de Remote Desktop Manager.

Instalación

A partir de Remote Desktop Manager 2023.1, se requiere PowerShell 7.2 o posterior para instalar el módulo. Para las versiones de Remote Desktop Manager anteriores a 2023.1, se requiere PowerShell 5.1 o posterior.

Instalación mediante PowerShell

Install-Module -Name Devolutions.PowerShell

Instalación manual

En algunas máquinas, puede ser necesario instalar el módulo manualmente. Estos son los pasos para completar este proceso:

1. Descargue el fichero NUPKG del módulo Devolutions.PowerShell desde PowerShell Gallery. 1. Cambie la extensión del fichero a .zip. 1. Extraiga el fichero en C:\Program Files\WindowsPowerShell\Modules\devolutions.powershell\version. 1. Desbloquee todos los ficheros recién extraídos.

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

Migración de sus scripts

Una vez instalado, la única modificación necesaria es eliminar el comando Import-Module de los scripts utilizados con el antiguo módulo de PowerShell de Remote Desktop Manager. Como el módulo ahora forma parte de los módulos de PowerShell instalados en el ordenador, ya no es necesario importarlo en los scripts.

Usar una configuración de anulación (portátil)

Mediante los cmdlets Get-RDMPowerShellOverride y Set-RDMPowerShellOverride, es posible elegir otra carpeta de destino para guardar los ficheros de configuración o seleccionar una carpeta distinta de la definida por defecto por el módulo Devolutions.PowerShell. Estos comandos también se pueden utilizar para seleccionar una carpeta que contenga ficheros de una configuración existente de Remote Desktop Manager distinta de la predeterminada.

Ambas propiedades son opcionales y se aplican sus valores predeterminados cuando se dejan vacías.

• OptionFilePath: la ruta completa al fichero RemoteDesktopManager.cfg

Valor predeterminado: %LOCALAPPDATA%\Devolutions\RemoteDesktopManager

• RemoteDesktopManagerExecutablePath: para el uso de Start-RDMSession o Start-RDMProcess

Valor predeterminado: %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

Resolución de problemas básica

A veces, puede parecer que se están utilizando varias versiones del módulo de PowerShell. Escribiendo $env:PSModulePath, podrá navegar a estas ubicaciones para eliminar los ficheros RemoteDesktopManager y RemoteDesktopManager.PowershellModule y reinstalar desde cero (cambiar el nombre no evita que el sistema analice esas ubicaciones y encuentre los módulos que contienen).

$env:PSModulePath

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

Consultar la versión de PowerShell y el fichero de configuración en uso

Get-RDMInstance

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