Vous pouvez utiliser l'interface de ligne de commande vdmutil pour configurer et gérer le mécanisme de sécurité utilisé lorsque des messages JMS sont transmis entre des composants VMware Horizon.
Syntaxe et emplacement de l'utilitaire
La commande vdmutil peut effectuer les mêmes opérations que la commande lmvutil qui était incluse avec les versions antérieures d'VMware Horizon. En outre, la commande vdmutil dispose d'options permettant de déterminer le mode de sécurité des messages utilisés et de surveiller l'avancement du passage de tous les composants VMware Horizon en mode Amélioré. Utilisez la forme suivante de la commande vdmutil à partir d'une invite de commande Windows.
vdmutil command_option [additional_option argument] ...
Les options supplémentaires que vous pouvez utiliser dépendent de l'option de commande. Cette rubrique met l'accent sur les options du mode de sécurité des messages. Pour les autres options, liées à Architecture Cloud Pod, reportez-vous au document Architecture Cloud Pod dans Horizon 8.
Par défaut, le chemin d'accès au fichier exécutable de la commande vdmutil est C:\Program Files\VMware\VMware View\Server\tools\bin. Pour éviter d'entrer le chemin d'accès sur la ligne de commande, ajoutez-le à la variable d'environnement PATH.
Authentification
Vous devez exécuter la commande en tant qu'utilisateur disposant du rôle Administrateurs. Vous pouvez utiliser Horizon Console pour affecter le rôle Administrateurs à un utilisateur. Reportez-vous à la section « Configuration de l'administration déléguée basée sur des rôles » du document Administration d'Horizon 8.
La commande vdmutil inclut des options pour spécifier le nom d'utilisateur, le domaine et le mot de passe à utiliser pour l'authentification.
| Option | Description |
|---|---|
| --authAs | Nom d'un utilisateur administrateur Horizon. N'utilisez ni le format domain\username ni le format de nom principal d'utilisateur (UPN). |
| --authDomain | Nom de domaine complet de l'utilisateur administrateur Horizon spécifié dans l'option --authAs. |
| --authPassword | Mot de passe de l'utilisateur administrateur Horizon spécifié dans l'option --authAs. Si vous entrez « * » plutôt qu'un mot de passe, la commande vdmutil affiche une invite de mot de passe et ne conserve pas les mots de passe sensibles dans l'historique des commandes sur la ligne de commande. |
Vous devez utiliser les options d'authentification avec toutes les options de la commande vdmutil, à l'exception de --help et de --verbose.
Options spécifiques aux modes de sécurité des messages JMS
Le tableau suivant répertorie uniquement les options de ligne de commande vdmutil qui concernent l'affichage, la configuration ou la surveillance du mode de sécurité des messages JMS. Pour consulter la liste des arguments que vous pouvez utiliser avec une option spécifique, utilisez l'option de ligne de commande --help.
La commande vdmutil renvoie 0 lorsqu'une opération réussit et un code différent de zéro spécifique d'un échec lorsqu'une opération échoue. La commande vdmutil écrit des messages d'erreur en format d'erreur standard. Lorsqu'une opération produit une sortie ou lorsque la journalisation détaillée est activée à l'aide de l'option --verbose, la commande vdmutil écrit la sortie en format de sortie standard en anglais américain.
| Option | Description |
|---|---|
| --activatePendingConnectionServerCertificates | Active un certificat de sécurité en attente pour une instance du Serveur de connexion dans l'espace local. |
| --countPendingMsgSecStatus | Compte le nombre de machines empêchant une transition vers ou depuis le mode Amélioré. |
| --createPendingConnectionServerCertificates | Crée un certificat de sécurité en attente pour une instance du Serveur de connexion dans l'espace local. |
| --getMsgSecLevel | Obtient l'état de sécurité des messages amélioré pour l'espace local. Cet état concerne le processus de modification du mode de sécurité des messages JMS permettant de passer d'Activé à Amélioré pour tous les composants d'un environnement VMware Horizon. |
| --getMsgSecMode | Obtient le mode de sécurité des messages pour l'espace local. |
| --help | Répertorie les options de la commande vdmutil. Vous pouvez également utiliser --help sur une commande particulière, comme --setMsgSecMode --help. |
| --listMsgBusSecStatus | Répertorie l'état de sécurité du bus de message pour tous les serveurs de connexion de l'espace local. |
| --listPendingMsgSecStatus | Répertorie les machines empêchant une transition vers ou depuis le mode Amélioré. Limité à 25 entrées par défaut. |
| --refreshDesktopCertificates | Actualisez les certificats de toutes les machines du poste de travail spécifié dans l'espace local. |
| --setMsgSecMode | Définit le mode de sécurité des messages de l'espace local. |
| --verbose | Active la journalisation détaillée. Vous pouvez ajouter cette option à n'importe quelle autre option pour obtenir une sortie de commande détaillée. La commande vdmutil écrit dans la sortie standard. |
