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

# Devolutions.PowerShell-Kernmodul

Das PowerShell-Modul muss nun aus der [PowerShell Gallery](https://www.powershellgallery.com/packages/Devolutions.PowerShell/) heruntergeladen werden. Es ist nicht länger im Installationspaket von Remote Desktop Manager enthalten. Das bedeutet auch, dass Remote Desktop Manager nicht auf einem Computer installiert sein muss, um PowerShell-Skripte auszuführen: Das Modul genügt nun.

{% hint style="info" %}
Um sich mit einer [erweiterten Datenquelle](https://docs.devolutions.net/rdm/de/getting-started/workspaces/workspace-types/native-workspaces) zu verbinden, muss dem Konto, das für die Verbindung mit der Datenquelle verwendet wird, eine Remote Desktop Manager-Lizenz zugewiesen sein.
{% endhint %}

### Installation

{% hint style="warning" %}
Ab Remote Desktop Manager 2023.1 ist PowerShell 7.2 oder höher für die Installation des Moduls erforderlich. Für Remote Desktop Manager-Versionen vor 2023.1 ist PowerShell 5.1 oder höher erforderlich.
{% endhint %}

#### PowerShell-Installation

`Install-Module -Name Devolutions.PowerShell`

#### Manuelle Installation

Auf einigen Computern kann es erforderlich sein, das Modul manuell zu installieren. Hier sind die Schritte, um diesen Vorgang abzuschließen:

1\. Laden Sie die [NUPKG-Datei des Devolutions.PowerShell-Moduls](https://www.powershellgallery.com/packages/Devolutions.PowerShell/) aus der PowerShell Gallery herunter. 1. Ändern Sie die Dateierweiterung auf .zip. 1. Extrahieren Sie die Datei nach **C:\Program Files\WindowsPowerShell\Modules\devolutions.powershell\version**. 1. Heben Sie die Blockierung aller neu extrahierten Dateien auf.

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

### Migration Ihrer Skripte

Nach der Installation besteht die einzige erforderliche Änderung darin, den Befehl `Import-Module` aus den Skripten zu entfernen, die mit dem alten Remote Desktop Manager PowerShell-Modul verwendet wurden. Da das Modul nun Teil der auf dem Computer installierten PowerShell-Module ist, muss es nicht mehr in die Skripte importiert werden.

### Eine Override-Konfiguration verwenden (portabel)

Mit den Cmdlets `Get-RDMPowerShellOverride` und `Set-RDMPowerShellOverride` ist es möglich, einen anderen Zielordner zum Speichern der Konfigurationsdateien zu wählen oder einen Ordner auszuwählen, der sich von dem standardmäßig durch das Modul Devolutions.PowerShell definierten unterscheidet. Diese Befehle können auch verwendet werden, um einen Ordner auszuwählen, der Dateien einer anderen als der Standardkonfiguration von Remote Desktop Manager enthält.

Beide Eigenschaften sind optional; wenn sie leer bleiben, werden ihre Standardwerte angewendet.

* OptionFilePath: der vollständige Pfad zur Datei **RemoteDesktopManager.cfg**

Standard: **%LOCALAPPDATA%\Devolutions\RemoteDesktopManager**

* RemoteDesktopManagerExecutablePath: für die Verwendung von `Start-RDMSession` oder `Start-RDMProcess`

Standard: **%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
```

### Grundlegende Fehlerbehebung

Manchmal kann es scheinen, dass mehrere Versionen des PowerShell-Moduls verwendet werden. Durch Eingabe von `$env:PSModulePath` können Sie zu diesen Speicherorten navigieren, um die Dateien RemoteDesktopManager und RemoteDesktopManager.PowershellModule zu löschen und eine Neuinstallation vorzunehmen (ein Umbenennen verhindert nicht, dass das System sie durchsucht und die darin enthaltenen Module findet).

```powershell
$env:PSModulePath

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

### PowerShell-Version und die verwendete Konfigurationsdatei abfragen

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