> 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/it/remote-desktop-manager-powershell/devolutions.powershell-core-module.md).

# Modulo core Devolutions.PowerShell

Il modulo PowerShell ora deve essere scaricato dal [PowerShell Gallery](https://www.powershellgallery.com/packages/Devolutions.PowerShell/). 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.

{% hint style="info" %}
Per connettersi a uno [spazio di lavoro avanzato](https://docs.devolutions.net/rdm/it/getting-started/workspaces/workspace-types/native-workspaces), l'account utilizzato per connettersi allo spazio di lavoro deve avere una licenza di Remote Desktop Manager assegnata.
{% endhint %}

### Installazione

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

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

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

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

### 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).

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

```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/it/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.