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:
Öffnen Sie die Windows PowerShell-Konsole.
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.
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"
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
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
Um die Hilfe für ein Cmdlet anzuzeigen, führen Sie
Get-Help
aus, indem Sie einen Cmdlet-Namen übergeben:Get-Help Get-RASGW
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
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.