Interfaccia a riga di comando della Devolutions Server Console

L'interfaccia a riga di comando (CLI) della Devolutions Server Console è uno strumento complementare che consente agli amministratori di interagire con le istanze di Devolutions Server, lo scheduler, il server di registrazione o un gateway tramite operazioni di creazione, configurazione o eliminazione. È automaticamente disponibile con l'installazione della Devolutions Server Console. Il file DPS.Console.CLI.exe si trova nella cartella di installazione dell'applicazione Devolutions Server Console.

Utilizzo della CLI

L'opzione /help elencherà tutti i comandi e i parametri disponibili.

L'opzione /help può essere utilizzata per elencare i parametri di un comando.

Il comando di esempio seguente avvia il processo di aggiornamento da un file ZIP disponibile nella cartella C:\temp.

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

Il comando seguente creerà una nuova istanza di Devolutions Server da un file di risposta JSON (vedere di seguito) che contiene i parametri richiesti. Può essere utilizzato con qualsiasi comando principale della CLI.

Esempio di file di risposta JSON per la creazione di una nuova istanza di Devolutions Server.

{
  "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
}

Procedura di emergenza

Un account break glass viene spesso utilizzato come meccanismo di ultima istanza per garantire che le operazioni IT essenziali o le funzioni di sicurezza possano continuare in caso di interruzione, guasto del sistema o incidente di sicurezza. Con l'interfaccia a riga di comando della Devolutions Server Console è possibile disabilitare l'autenticazione personalizzata e abilitarla su richiesta se il provider di identità principale non è in servizio. L'account personalizzato dell'amministratore deve essere già stato creato nell'istanza di Devolutions Server.

Tenga presente che deve sostituire dvls (dopo ...\wwwroot\) con il nome della sua applicazione IIS Devolutions Server personalizzata.

Abilitazione dell'autenticazione personalizzata

Nella CLI inserisca:

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

oppure

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

Disabilitazione dell'autenticazione personalizzata

Una volta completate le operazioni necessarie:

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

oppure

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