> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell/es/remote-desktop-manager-powershell/devolutions.powershell-core-module.md).

# Módulo principal Devolutions.PowerShell

Ahora el módulo de PowerShell debe descargarse desde [PowerShell Gallery](https://www.powershellgallery.com/packages/Devolutions.PowerShell/). 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.

{% hint style="info" %}
Para conectarse a un [espacio de trabajo avanzado](https://docs.devolutions.net/rdm/es/getting-started/workspaces/workspace-types/native-workspaces), la cuenta utilizada para conectarse al espacio de trabajo debe tener asignada una licencia de Remote Desktop Manager.
{% endhint %}

### Instalación

{% hint style="warning" %}
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.
{% endhint %}

#### 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](https://www.powershellgallery.com/packages/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.

```powershell
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**

```powershell
$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).

```powershell
$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

```powershell
Get-RDMInstance

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell/es/remote-desktop-manager-powershell/devolutions.powershell-core-module.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.