Interfaz de línea de comandos de Devolutions Server Console

La interfaz de línea de comandos (CLI) de la Devolutions Server Console es una herramienta complementaria que permite a los administradores interactuar con instancias de Devolutions Server, el programador, el servidor de grabación o una puerta de enlace mediante operaciones de creación, configuración o eliminación. Está disponible automáticamente con la instalación de la Devolutions Server Console. El fichero DPS.Console.CLI.exe se encuentra en la carpeta de instalación de la aplicación Devolutions Server Console.

Uso de la CLI

El modificador /help mostrará todos los comandos y parámetros disponibles.

El modificador /help puede utilizarse para mostrar los parámetros de un comando.

El siguiente comando de ejemplo inicia el proceso de actualización a partir de un fichero ZIP disponible en la carpeta 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.

El siguiente comando creará una nueva instancia de Devolutions Server a partir de un fichero de respuestas JSON (véase más abajo) que contiene los parámetros necesarios. Puede utilizarse con cualquiera de los comandos principales de la CLI.

Ejemplo de un fichero de respuestas JSON para crear una nueva instancia de 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
}

Procedimiento de emergencia

Una cuenta break glass se utiliza a menudo como mecanismo de último recurso para garantizar que las operaciones de TI esenciales o las funciones de seguridad puedan continuar en caso de interrupción, fallo del sistema o incidente de seguridad. Con la interfaz de línea de comandos de la Devolutions Server Console, podemos desactivar la autenticación personalizada y activarla a demanda si el proveedor de identidad principal está fuera de servicio. La cuenta personalizada de administrador debe haberse creado previamente en la instancia de Devolutions Server.

Tenga en cuenta que debe reemplazar dvls (después de ...\wwwroot\) por el nombre personalizado de su propia aplicación IIS de Devolutions Server.

Activar la autenticación personalizada

En la CLI introduzca cualquiera de las siguientes opciones:

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

o

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

Desactivar la autenticación personalizada

Cuando haya terminado con las operaciones necesarias:

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

o

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