> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/server/de/knowledge-base/knowledge-base-articles/devolutions-server-console-command-line-interface.md).

# 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.

<figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB8032.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB8033.png" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB8034.png" alt=""><figcaption></figcaption></figure>

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

```json
{
  "acceptEula": true,
  "adminEmail": "admin@mydomain.org",
  "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.

{% hint style="info" %}
Bitte beachten Sie, dass Sie `dvls` (nach ...`\wwwroot\`) durch Ihren eigenen benutzerdefinierten ***Devolutions Server*** IIS-Anwendungsnamen ersetzen sollten.
{% endhint %}

**Custom-Authentifizierung aktivieren**

Geben Sie in der CLI entweder Folgendes ein:

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

oder

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

**Custom-Authentifizierung deaktivieren**

Wenn die erforderlichen Vorgänge abgeschlossen sind:

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

oder

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/server/de/knowledge-base/knowledge-base-articles/devolutions-server-console-command-line-interface.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
