> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-admin-guide/v22-de-de/parallels-ras-apis/ras-powershell-api.md). # RAS PowerShell API Die RAS-PowerShell-API richtet sich an RAS-Administratoren, die ihre RAS-Verwaltung automatisieren möchten. Die API enthält Befehle zur Ausführung der meisten RAS-Verwaltungsaufgaben. ### **Anforderungen für Parallels RAS** Die Version der Parallels RAS Windows PowerShell-API muss mit der Version des RAS Connection Brokers übereinstimmen, mit dem sie kommuniziert. Da die beiden Komponenten separat installiert werden können, müssen Sie sicherstellen, dass ihre Versionen übereinstimmen. ### **Anforderungen an Microsoft Windows-Komponenten** Die folgenden Komponenten müssen auf dem Computer installiert sein, auf dem Sie die Parallels RAS PowerShell-Cmdlets ausführen möchten: * Windows PowerShell 3.0 oder höher * Microsoft .NET Framework 4.5.2 oder höher ### **Installation** Um Parallels RAS PowerShell zu installieren, führen Sie das Standard-Installationsprogramm von Parallels RAS aus, wählen Sie die Option **„Benutzerdefinierte**“ Installation und wählen Sie anschließend die Komponente **„Parallels RAS PowerShell“** zur Installation aus. Folgen Sie die Anweisungen auf dem Bildschirm, um die Komponente zu installieren. ### **RAS-PowerShell-API-Versionen** Die RAS-PowerShell-API hat in Parallels RAS 18 folgende Änderungen erfahren: * Der Name des RAS-PowerShell-Moduls wurde von „PSAdmin“ in „RASAdmin“ geändert. * Die meisten Befehle tragen jetzt das Präfix „RAS“, wie beispielsweise RASGW oder RASApply. * API-Versionen: Version 2.0 (aktuellste) und Version 1.0 werden aus Gründen der Abwärtskompatibilität unterstützt. Bitte beachten Sie, dass die API-Version 1.0 im aktuellen RAS-PowerShell-Modul weiterhin verfügbar ist. Falls Sie bereits Skripte haben, die das ältere Modul und die älteren Befehlsnamen verwenden, können Sie diese mit minimalen Änderungen weiterverwenden. Dazu müssen Sie beim Importieren des RAS-PowerShell-Moduls die API-Version 1.0 laden. Weitere Informationen zu den API-Versionen finden Sie weiter unten. **Version 2.0** Diese Version wird standardmäßig vom System geladen oder wenn der Parameter `-RequiredVersion` beim Importieren des Moduls nicht angegeben wird. Beispiele finden Sie unter **Grundlagen der RAS-Windows-PowerShell-API**. **Version 1.0** Diese Version ist abwärtskompatibel mit dem alten PSAdmin-Modul, sodass Administratoren vorhandene Skripte mit geringfügigen Anpassungen weiterverwenden können. Diese Version umfasst: * Cmdlet-Aliase * Parameter mit Aliasen * Gibt alte und neue Eigenschaften zurück ### **Grundlagen der RAS Windows PowerShell-API** Um schnell mit RAS PowerShell zu beginnen, gehen Sie wie folgt vor: 1. Öffnen Sie die Windows PowerShell-Konsole. 2. Importieren Sie das Parallels RAS PowerShell-Modul mit einem der folgenden Befehle: * `Import-Module RASAdmin —` Lädt die aktuelle API (Version 2.0). * `Import-Module RASAdmin -RequiredVersion 1.0 —` Importiert die API-Version 1.0. 3. Erstellen Sie eine Parallels RAS-Sitzung, indem Sie das Cmdlet `New-RASSession` ausführen (siehe Beispiel unten). WECHSELN Sie den Servernamen (in Anführungszeichen) durch den Namen oder die IP-Adresse Ihres Parallels RAS-Lizenzservers. Geben Sie Ihren RAS-Administrator-Benutzernamen und Ihr Passwort ein, wenn Sie dazu aufgefordert werden: `New-RASSession -Server "server.company.dom"` 4. Führen Sie das folgende Cmdlet aus, um die Liste der im Parallels RAS-PowerShell-Modul enthaltenen Cmdlets anzuzeigen: `Get-Command -Module RASAdmin` 5. Führen Sie weitere Cmdlets aus. Versuchen Sie beispielsweise, das Cmdlet `Get-RASW` auszuführen, um Informationen zu RAS Secure Gateways abzurufen. Das folgende Beispiel gibt Informationen zu allen RAS Secure Gateways zurück, die auf der RAS-Lizenzserver-Site verfügbar sind: `Get-RASGW` 6. Um die Hilfe zu einem Cmdlet anzuzeigen, führen Sie `Get-Help` aus und geben Sie dabei den Namen des Cmdlets weiter: `Get-Help Get-RASGW` 7. Um Änderungen, die Sie an der Farmkonfiguration vorgenommen haben, anzuwenden, verwenden Sie das Cmdlet `Invoke-RASApply` (dies führt dieselbe Aktion aus wie die Schaltfläche **Anwenden** in der RAS-Konsole): `Invoke-RASApply` 8. Um eine Parallels RAS-Lizenz zu aktivieren, verwenden Sie das Cmdlet `Invoke-RASLicenseActivate`: `Invoke-RASLicenseActivate` Bei der Ausführung des oben genannten Cmdlets werden Sie aufgefordert, die E-Mail-Adresse und das Passwort Ihres Parallels-Kontos einzugeben. Sie können optional den Parameter `-Key` einschließen und einen Parallels RAS-Lizenzschlüssel eingeben. Wird dieser weggelassen (wie im obigen Beispiel), wird Parallels RAS als Testversion aktiviert. ### **Parallels RAS Windows PowerShell-Handbuch** Um das neue **Parallels RAS Windows PowerShell-Handbuch**, Version 2.0, anzuzeigen und herunterzuladen, besuchen Sie die Parallels-Website unter [https://www.parallels.com/products/ras/resources](https://www.parallels.com/products/ras/resources/). --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.parallels.com/landing/ras-admin-guide/v22-de-de/parallels-ras-apis/ras-powershell-api.md?ask=&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 `automate deployments from our CI pipeline` 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.