Mit der Befehlszeilenschnittstelle vdmutil können Sie den Sicherheitsmechanismus konfigurieren und verwalten, der bei der Übertragung von JMS-Nachrichten zwischen VMware Horizon-Komponenten verwendet wird.
Syntax und Speicherort des Dienstprogramms
Der Befehl vdmutil bewirkt dasselbe wie der Befehl lmvutil aus früheren Versionen von VMware Horizon. Darüber hinaus ermöglicht der Befehl vdmutil die Festlegung des verwendeten Sicherheitsmodus für Nachrichten sowie die Überwachung des Fortschritts der Umstellung aller VMware Horizon-Komponenten auf den erweiterten Modus. Verwenden Sie den Befehl vdmutil an einer Windows-Eingabeaufforderung mit dem folgenden Format.
vdmutil command_option [additional_option argument] ...
Welche Zusatzoptionen verwendet werden können, hängt von der Befehlsoption ab. Dieses Thema befasst sich mit den Optionen für den Sicherheitsmodus für Nachrichten. Informationen zu den anderen Optionen im Zusammenhang mit der Cloud-Pod-Architektur finden Sie im Dokument Cloud-Pod-Architektur in Horizon.
Der Pfad zur ausführbaren Datei des Befehls vdmutil lautet standardmäßig C:\Programme\VMware\VMware View\Server\tools\bin. Damit Sie den Pfad nicht in die Befehlszeile eingeben müssen, fügen Sie ihn zur PATH-Umgebungsvariable hinzu.
Authentifizierung
Sie müssen den Befehl als Benutzer mit der Administratorrolle ausführen. Sie können einem Benutzer die Administratorrolle mithilfe von Horizon Console zuweisen. Siehe „Konfigurieren der rollenbasierten Verwaltungsdelegierung“ im Dokument Horizon-Verwaltung.
Der vdmutil-Befehl umfasst Optionen zur Angabe des Benutzernamens, der Domäne und des Kennworts für die Authentifizierung.
| Option | Beschreibung |
|---|---|
| --authAs | Der Name eines Horizon-Administratorbenutzers. Verwenden Sie nicht das Format Domäne\Benutzername oder das UPN-Format (Benutzerprinzipalname). |
| --authDomain | Der vollqualifizierte Domänenname für den mit der Option --authAs angegebenen Horizon-Administratorbenutzer. |
| --authPassword | Das Kennwort für den mit der Option --authAs angegebenen Horizon-Administratorbenutzer. Wenn "*" anstelle eines Kennworts eingegeben wird, fordert der Befehl vdmutil zur Eingabe des Kennworts auf. Vertrauliche Kennwörter werden dann nicht im Befehlsverlauf der Befehlszeile hinterlassen. |
Sie müssen die Authentifizierungsoptionen mit allen vdmutil-Befehlsoptionen verwenden, mit Ausnahme von --help und --verbose.
Spezielle Optionen für den Sicherheitsmodus für JMS-Nachrichten
Die folgende Tabelle enthält nur die vdmutil-Befehlszeilenoptionen für das Anzeigen, Festlegen oder Überwachen des Sicherheitsmodus für JMS-Nachrichten. Über die --help-Befehlszeilenoption erhalten Sie eine Liste der Argumente, die für eine bestimmte Option verwendet werden können.
Der Befehl vdmutil gibt 0 zurück, wenn ein Vorgang erfolgreich ist, und einen fehlerspezifischen Code ungleich null, wenn ein Vorgang fehlschlägt. Der Befehl vdmutil schreibt Fehlermeldungen in die Standardfehler. Wenn ein Vorgang eine Ausgabe erzeugt oder die ausführliche Protokollierung mithilfe der Option --verbose aktiviert ist, schreibt der Befehl vdmutil die Ausgabe in US-Englisch in die Standardausgabe.
| Option | Beschreibung |
|---|---|
| --activatePendingConnectionServerCertificates | Aktiviert ein ausstehendes Sicherheitszertifikat für eine Verbindungsserver-Instanz im lokalen Pod. |
| --countPendingMsgSecStatus | Zählt die Anzahl der Maschinen, die die Umstellung auf den erweiterten Modus bzw. vom erweiterten Modus verhindern. |
| --createPendingConnectionServerCertificates | Erstellt ein neues ausstehendes Sicherheitszertifikat für eine Verbindungsserver-Instanz im lokalen Pod. |
| --getMsgSecLevel | Ruft den erweiterten Nachrichten-Sicherheitsstatus für den lokalen Pod ab. Dieser Status ist Teil des Prozesses zur Änderung des JMS-Nachrichtensicherheitsmodus von Aktiviert in Erweitert für alle Komponenten in einer VMware Horizon-Umgebung. |
| --getMsgSecMode | Ruft den Sicherheitsmodus für Nachrichten für den lokalen Pod ab. |
| --help | Listet die Optionen des Befehls vdmutil auf. Sie können auch die Option --help mit einem bestimmten Befehl verwenden, z. B. --setMsgSecMode --help. |
| --listMsgBusSecStatus | Listet den Nachrichtenbus-Sicherheitsstatus für alle Verbindungsserver im lokalen Pod auf. |
| --listPendingMsgSecStatus | Listet die Maschinen auf, die die Umstellung auf den erweiterten Modus bzw. vom erweiterten Modus verhindern. Standardmäßig auf 25 Einträge beschränkt. |
| --refreshDesktopCertificates | Aktualisiert die Zertifikate für alle Maschinen des angegebenen Desktops im lokalen Pod. |
| --setMsgSecMode | Legt den Sicherheitsmodus für Nachrichten für den lokalen Pod fest. |
| --verbose | Aktiviert ausführliche Protokollierung. Sie können diese Option mit jeder anderen Option kombinieren, um eine detaillierte Befehlsausgabe zu erhalten. Mit dem Befehl vdmutil erhalten Sie eine Standardausgabe. |
