Sie können die Befehlszeilenschnittstelle (Command Line Interface, CLI) der VMware Aria Automation-Appliance verwenden, um verschiedene Automation Orchestrator-Optionen zu konfigurieren. Diese Optionen können auch im Control Center der Automation Orchestrator-Bereitstellung aktualisiert werden. Um die CLI-Befehle verwenden zu können, müssen Sie sich bei der VMware Aria Automation-Appliance als root-Benutzer anmelden.

Mit Befehlen der Befehlszeilenschnittstelle können Sie die folgenden Automation Orchestrator-Optionen konfigurieren:

  • Lizenzkonfiguration
  • Konfiguration von Systemeigenschaften
  • Konfiguration von Erweiterungen
  • Fehlerbehebung
  • Abruf von Systeminformationen
  • Protokollierungskonfiguration

Lizenzkonfiguration

Sie können die aktuelle Automation Orchestrator-Lizenzkonfiguration abrufen, indem Sie den folgenden Befehl ausführen:

vracli vro license

"Sie können einen neuen Lizenzschlüssel festlegen, indem Sie folgenden Befehl ausführen:"

vracli vro license set <license_key>

"Sie können die aktuelle Lizenz auf die Standardlizenz des Authentifizierungsanbieters zurücksetzen, indem Sie folgenden Befehl ausführen:"

vracli vro license default

Konfiguration von Systemeigenschaften

Sie können eine Liste aller konfigurierten Automation Orchestrator-Systemeigenschaften als JSON-Datei abrufen, indem Sie den folgenden Befehl ausführen:

vracli vro properties

"Sie können eine Systemeigenschaft festlegen, indem Sie folgenden Befehl ausführen:"

vracli vro properties set

Dieser Systemeigenschaftsbefehl hat die folgenden Eigenschaften:

Eigenschaft Gewichtung Beschreibung
-k oder --key Erforderlich "Diese Eigenschaft definiert den Namen der Systemeigenschaft, die Sie festlegen möchten."
-v oder --value Erforderlich Diese Eigenschaft definiert den Wert der Systemeigenschaft.
-n oder --noRestart Optional Diese Eigenschaft definiert, ob die festgelegte Systemeigenschaft einen Neustart des Automation Orchestrator-Diensts erfordert. Standardmäßig wird beim Festlegen einer neuen Systemeigenschaft ein Neustart des Diensts durchgeführt.

Im Folgenden finden Sie ein Beispiel für diesen Systemeigenschaftsbefehl.

vracli vro properties set -k com.vmware.o11n.property -v true

"Sie können vorhandene Systemeigenschaften entfernen, indem Sie folgenden Befehl ausführen:"

vracli vro properties remove -k <key_value>
Hinweis: Die Eigenschaft -k oder --key muss den Namen der Systemeigenschaft enthalten, die Sie entfernen möchten.

"Sie können den Namen, den Wert und die Beschreibung der am häufigsten verwendeten Systemeigenschaften abrufen, indem Sie den folgenden Befehl ausführen:"

vracli vro properties advanced

Konfiguration von Erweiterungen

Sie können eine Liste aller konfigurierten Automation Orchestrator-Erweiterungen abrufen, indem Sie den folgenden Befehl ausführen: 

vracli vro extensions

"Sie können eine Erweiterung aktivieren, indem Sie folgenden Befehl ausführen:"

vracli vro extensions <extension_name> activate

"Sie können eine Erweiterung deaktivieren, indem Sie folgenden Befehl ausführen:"

vracli vro extensions <extension_name> deactivate

"Sie können alle Konfigurationseigenschaften einer bestimmten Erweiterung auflisten, indem Sie folgenden Befehl ausführen:"

vracli vro extensions <extension_name> list

"Sie können eine Erweiterungseigenschaft festlegen, indem Sie folgenden Befehl ausführen:"

vracli vro extensions <extension> set

Dieser Erweiterungseigenschaftsbefehl kann die folgenden Eigenschaften haben:

Eigenschaft Gewichtung Beschreibung
-k oder --key Erforderlich Diese Eigenschaft definiert die ID der Erweiterungseigenschaft.
-v oder --value Erforderlich Diese Eigenschaft definiert den Wert der Erweiterungseigenschaft.

Der Workflow zum Aktivieren einer Erweiterung, Auflisten aller zugehörigen Eigenschaften und Festlegen einer Systemeigenschaft könnte beispielsweise wie folgt aussehen:

vracli vro extensions tokenreplay activate
vracli vro extensions tokenreplay list
vracli vro extensions tokenreplay set -k recordScripting -v true

Fehlerbehebung

"Sie können alle aktiven Workflow-Ausführungen abbrechen, indem Sie folgenden Befehl ausführen:"

vracli vro cancel executions

Sie können die Ausführung eines bestimmten Workflows abbrechen, indem Sie die zugehörige ID zum folgenden Befehl hinzufügen:

vracli vro cancel workflow <workflow_id>

"Sie können alle aktiven geplanten Aufgaben anhalten, indem Sie folgenden Befehl ausführen:"

vracli vro cancel tasks

"Sie können eine Liste aller vertrauenswürdigen Zertifikate abrufen, indem Sie folgenden Befehl ausführen:"

vracli vro keystore list

Systeminformationen

Sie können die aktuellen Systeminformationen Ihrer Automation Orchestrator-Bereitstellung abrufen, indem Sie folgenden Befehl ausführen:

vracli vro info
Hinweis: Sie können die optionale Eigenschaft -d oder --details zum Systeminformationsbefehl hinzufügen, um die Integritätsstatus-API des Automation Orchestrator-Servers zu überprüfen.

Protokollierungskonfiguration

Sie können die aktuelle Automation Orchestrator-Protokollierungskonfiguration abrufen, indem Sie den folgenden Befehl ausführen:

vracli vro logs

Sie können den Automation Orchestrator-Protokollierungsserver konfigurieren, indem Sie den folgenden Befehl ausführen:

vracli vro logs configure

Der Protokollierungsserverbefehl kann die folgenden Parameter haben:

Parameter Gewichtung Beschreibung
-l oder --level Optional Dieser Parameter definiert die Protokollierungsebene des Servers.
-sc oder --scripting-count Optional Dieser Parameter definiert die Anzahl der gespeicherten Skriptprotokollrotationen.
-sl oder --scripting-level Optional Dieser Parameter definiert die Skriptprotokollebene.
-ss oder --scripting-size Optional Dieser Parameter definiert die Skriptprotokollgröße in Megabyte (MB).
Hinweis: Die gültigen Ebenenwerte sind ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL und OFF.

CLI-Befehlsprotokolle

Die gedruckten Protokolle von Automation Orchestrator-CLI-Befehlen werden unter /services-logs/prelude/vco-app/file-logs/vco-server-app_cfg-cli.log abgelegt. Wenn ein Befehl ein anderes Ergebnis als Null zurückgibt und die Standardausgabe keinen bestimmten Fehler enthält, wird die Ausnahme in dieser Datei angezeigt.