> 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

Instale y configure el módulo Devolutions.PowerShell desde PowerShell Gallery, incluyendo la instalación manual, la migración de scripts y la resolución de problemas.

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 following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.
