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.