Befehlszeilenschnittstelle der Devolutions Server Console

Die Befehlszeilenschnittstelle (CLI) der Devolutions Server Console ist ein Begleitwerkzeug, mit dem Administratoren mit Devolutions Server-Instanzen, dem Scheduler, dem Aufzeichnungsserver oder einem Gateway interagieren können, um Erstellungs-, Konfigurations- oder Löschvorgänge durchzuführen. Sie ist automatisch mit der Installation der Devolutions Server Console verfügbar. Die Datei DPS.Console.CLI.exe befindet sich im Installationsordner der Devolutions Server Console-Anwendung.

Verwendung der CLI

Der Schalter /help listet alle verfügbaren Befehle und Parameter auf.

Der Schalter /help kann verwendet werden, um Befehlsparameter aufzulisten.

Der folgende Beispielbefehl startet den Upgrade-Prozess aus einer ZIP-Datei, die im Ordner C:\temp verfügbar ist.

.\DPS.Console.CLI.exe server upgrade --dps "Default Web Site/dps" --zip "C:\temp\DVLS.20XX.X.X.X.zip" --accept-eula -quiet -verbose.

Der folgende Befehl erstellt eine neue Devolutions Server-Instanz aus einer JSON-Antwortdatei (siehe unten), die die erforderlichen Parameter enthält. Er kann mit jedem der Hauptbefehle der CLI verwendet werden.

Beispiel einer JSON-Antwortdatei zum Erstellen einer neuen Devolutions Server-Instanz.

{
  "acceptEula": true,
  "adminEmail": "[e-mail]",
  "adminPassword": "AdminPassword",
  "adminUsername": "admin",
  "appPoolIdentityType": "Network Service",
  "appPoolIdentityPassword": null,
  "appPoolIdentityUsername": null,
  "command": "server install",
  "consolepwd": "MyConsolePassword",
  "databaseHost": "SQLServer\SQL2017",
  "databaseIntegratedSecurity": false,
  "databaseName": "DSERVER",
  "databaseConsolePassword": "MyPassword",
  "databaseConsoleUsername": "VaultDBOwner",
  "databaseSchedulerPassword": "MyPassword",
  "databaseSchedulerUsername": "VaultDBScheduler",
  "databaseVaultPassword": "MyPassword",
  "databaseVaultUsername": "VaultDBRunner",
  "debug": false,
  "disableEncryptConfig": false,
  "disableHttps": false,
  "disablePassword": false,
  "dpsPath": "C:\\inetpub\\wwwroot\\dvls",
  "dpsWebsiteName": "Default Web Site",
  "installZip": null,
  "keysPath": "C:\\temp\\DVLS_EncryptionKeys.bin",
  "keysPassword": "MyKeysPassword",
  "quiet": false,
  "scheduler": true,
  "serial": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
  "serverName": "Devolutions Server",
  "serviceAccount": "LocalSystem",
  "servicePassword": null,
  "serviceUser": null,
  "webApplicationName": "/dvls",
  "verbose": false
}

Notfallverfahren

Ein Break-Glass-Konto wird häufig als letztes Mittel verwendet, um sicherzustellen, dass wesentliche IT-Vorgänge oder Sicherheitsfunktionen im Falle eines Ausfalls, eines Systemfehlers oder eines Sicherheitsvorfalls fortgesetzt werden können. Mit der Befehlszeilenschnittstelle der Devolutions Server Console können wir die Custom-Authentifizierung deaktivieren und bei Bedarf aktivieren, wenn der Haupt-Identitätsanbieter nicht verfügbar ist. Das benutzerdefinierte Administratorkonto muss bereits in der Devolutions Server-Instanz erstellt worden sein.

Bitte beachten Sie, dass Sie dvls (nach ...\wwwroot\) durch Ihren eigenen benutzerdefinierten Devolutions Server IIS-Anwendungsnamen ersetzen sollten.

Custom-Authentifizierung aktivieren

Geben Sie in der CLI entweder Folgendes ein:

server instance --instance=C:\inetpub\wwwroot\dvls --enable-custom-authentication=true

oder

server instance --instance=C:\inetpub\wwwroot\dvls --custom-auth=true

Custom-Authentifizierung deaktivieren

Wenn die erforderlichen Vorgänge abgeschlossen sind:

server instance --instance=C:\inetpub\wwwroot\dvls --enable-custom-authentication=false

oder

server instance --instance=C:\inetpub\wwwroot\dvls --custom-auth=false