# RAS PowerShell API

Die RAS PowerShell-API ist für RAS-Administratoren gedacht, 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 Parallels RAS PowerShell-API-Version muss mit der Version des RAS Connection Broker übereinstimmen, mit dem sie kommuniziert. Da die beiden Komponenten getrennt 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 Parallels RAS PowerShell-Cmdlets ausführen:

* 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 den standardmäßigen Parallels RAS-Installer aus, wählen Sie **Benutzerdefinierte** Installation und dann die Option zur Installation der **Parallels RAS PowerShell**-Komponente. Befolgen Sie die Anweisungen auf dem Bildschirm, um die Komponente zu installieren.

**RAS PowerShell-API-Versionen**

Die RAS PowerShell-API wurde in Parallels RAS 18 wie folgt geändert:

* Der Name des RAS PowerShell-Moduls wurde von PSAdmin in RASAdmin geändert.
* Die meisten Befehle haben jetzt das Präfix „RAS“, z. B. RASGW oder RASApply.
* API-Versionen: Version 2.0 (neueste) und Version 1.0 werden aus Gründen der Abwärtskompatibilität unterstützt.

Beachten Sie, dass die API-Version 1.0 im aktuellen RAS PowerShell-Modul noch verfügbar ist. Wenn Sie vorhandene Skripte haben, die die älteren Modul- und Befehlsnamen verwenden, müssen Sie diese nur minimal ändern, um sie verwenden zu können. Dazu müssen Sie die API-Version 1.0 laden, wenn Sie das RAS PowerShell-Modul importieren. Weitere Informationen zu den API-Versionen finden Sie unten.

**Version 2.0**

Hierbei handelt es sich um die Version, die standardmäßig vom System geladen wird oder wenn der Parameter `-RequiredVersion` beim Importieren des Moduls nicht angegeben wird. Beispiele finden Sie unter **RAS PowerShell-API-Konzepte**.

**Version 1.0**

Diese Version bleibt abwärtskompatibel mit dem alten PSAdmin-Modul, damit Administratoren vorhandene Skripte mit geringfügigen Änderungen verwenden können. Diese Version enthält:

* Cmdlet-Aliase
* Parameteraliase
* Gibt alte und neue Eigenschaften zurück

**RAS PowerShell-API-Konzepte**

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-Modul RASAdmin` – Lädt die aktuelle API (Version 2.0).
   * `Import-Module RASAdmin -RequiredVersion 1.0 –` Lädt die API-Version 1.0.
3. Erstellen Sie eine Parallels RAS-Sitzung, indem Sie das Cmdlet `New-RASSession` ausführen (siehe Beispiel unten). Ersetzen 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 Cmdlets anzuzeigen, die im Parallels RAS PowerShell-Modul enthalten sind:

   `Get-Command -Module RASAdmin`
5. Führen Sie andere Cmdlets aus. Versuchen Sie beispielsweise, das Cmdlet `Get-RASW` auszuführen, um Informationen über RAS Secure Gateway(s) abzurufen. Das folgende Beispiel gibt Informationen über alle RAS Secure Gateways zurück, die auf der RAS Licensing Server-Seite verfügbar sind:

   `Get-RASGW`
6. Um die Hilfe für ein Cmdlet anzuzeigen, führen Sie `Get-Help` aus, indem Sie einen Cmdlet-Namen übergeben:

   `Get-Help Get-RASGW`
7. Um Änderungen, die Sie an der Farm-Konfiguration vorgenommen haben, anzuwenden, verwenden Sie das Cmdlet `Invoke-RASApply` (dies führt die gleiche Aktion aus wie die Schaltfläche **Übernehmen** in der RAS-Konsole):

   `Invoke-RASApply`
8. Um eine Parallels RAS-Lizenz zu aktivieren, verwenden Sie das Cmdlet `Invoke-RASLicenseActivate`:

   `Invoke-RASLicenseActivate`

   Wenn Sie das obige Cmdlet ausführen, werden Sie aufgefordert, Ihre E-Mail-Adresse und Ihr Passwort für das Parallels-Konto einzugeben. Sie können einen optionalen `-Key`-Parameter hinzufügen und einen Parallels RAS-Lizenzschlüssel angeben. Ohne diese Angabe (wie im obigen Beispiel) wird Parallels RAS als Testversion aktiviert.

**Parallels RAS PowerShell-Anleitung**

Um den neuen **Parallels RAS PowerShell Guide** Version 2.0 anzuzeigen und herunterzuladen, besuchen Sie die Parallels-Website unter [https://www.parallels.com/de/products/ras/resources](https://www.parallels.com/products/ras/resources/).