Skip to main content

7 mai 2025

Exécution d'Horizon Windows Client à partir de la ligne de commande

Vous pouvez exécuter Omnissa Horizon Client à partir de la ligne de commande ou via des scripts. Vous pouvez exécuter Omnissa Horizon Client à partir de la ligne de commande si vous mettez en place une application kiosque qui accorde l'accès des utilisateurs finaux aux applications de poste de travail distant.

Pour exécuter Horizon Client à partir de la ligne de commande, utilisez la commande exécutable qui partage le même nom que le fichier exécutable de l'application. La commande exécutable inclut des options que vous pouvez spécifier pour modifier le comportement d'Horizon Client.

Utilisation des commandes Horizon Client

La syntaxe de la commande exécutable contrôle le fonctionnement d'Horizon Client.

Utilisez la forme suivante de la commande exécutable à partir d'une invite de commande Windows.

[executable] [command_line_option [argument]] ...

Le chemin d'accès par défaut au fichier exécutable de la commande exécutable varie en fonction du système client. Vous pouvez ajouter ce chemin d'accès à la variable d'environnement PATH sur le système client.

Le tableau suivant présente les options de ligne de commande que vous pouvez utiliser avec la commande exécutable.

Options de ligne de commande d'Horizon Client
OptionDescription
/?Affiche la liste d'options de commande.
-appName application_nameSpécifie le nom de l'application publiée tel qu'il apparaît dans la fenêtre de sélection des postes de travail et applications. Il s'agit du nom d'affichage spécifié pour le pool d'applications dans l'assistant de création de pool.
Protocole -appProtocolSpécifie le protocole d'affichage de l'application publiée à utiliser, si disponible. Les protocoles valides sont les suivants :
  • Blast
  • PCoIP
Argument -appSessionReconnectionBehaviorSpécifie le paramètre de comportement de reconnexion des applications publiées. Les arguments valides sont les suivants :
  • toujours

    Applique le paramètre Se reconnecter automatiquement pour ouvrir des applications.

  • jamais

    Applique le paramètre Ne pas demander la reconnexion et ne pas se reconnecter automatiquement.

  • demander

    Applique le paramètre Demander la reconnexion pour ouvrir des applications.

Lorsque vous utilisez cette option, les paramètres de reconnexion d'applications publiées sont désactivés dans Horizon Client.
Argument -argsSpécifie les arguments de ligne de commande à ajouter au démarrage d'une application publiée. Par exemple :
[executable] -serverURL
10.10.10.10 -appName "My Notepad++" -args "\"my new.txt\""
-connectUSBOnStartupLorsque cette option est définie sur true, tous les périphériques USB actuellement connectés à l'hôte sont redirigés vers le poste de travail distant ou l'application publiée. Cette option est implicitement définie si vous spécifiez l'option -unattended pour un poste de travail distant. La valeur par défaut est false.
-connectUSBOnInsertLorsque cette option est définie sur true, un périphérique USB est connecté au poste de travail distant ou à l'application publiée au premier plan lorsque vous branchez le périphérique. Cette option est implicitement définie si vous spécifiez l'option -unattended pour un poste de travail distant. La valeur par défaut est false.
-desktopLayout window_sizeSpécifie comment afficher la fenêtre du poste de travail distant. Les valeurs de taille de fenêtre valides sont les suivantes :
  • fullscreen

    Affichage en plein écran.

  • multimoniteur

    Affichage sur plusieurs moniteurs.

  • windowLarge

    Grande fenêtre.

  • windowSmall

    Petite fenêtre.

  • length X width

    Taille personnalisée, par exemple, 800 × 600.

-desktopName desktop_nameSpécifie le nom du poste de travail distant tel qu'il apparaît dans la fenêtre de sélection des postes de travail et applications. Il s'agit du nom d'affichage spécifié pour le pool dans l'assistant de création de pool. Important : ne spécifiez pas cette option pour les clients en mode Kiosque. Cette option n'a aucun effet lorsque le poste de travail distant s'exécute en mode Kiosque. Pour le mode Kiosque, la connexion est établie au premier poste de travail distant dans la liste des postes de travail distants octroyés.
-desktopProtocol protocolSpécifie le protocole d'affichage à utiliser tel qu'il apparaît dans la fenêtre de sélection des postes de travail et applications. Les protocoles d'affichage valides sont les suivants :
  • Blast
  • PCoIP
  • RDP
-domainName domain_nameSpécifie le domaine NETBIOS que l'utilisateur final utilise pour ouvrir une session d'Horizon Client. Utilisez par exemple mycompany plutôt que mycompany.com.
-file file_pathSpécifie le chemin d'accès d'un fichier de configuration qui contient des options et des arguments de commande supplémentaires.
-hAffiche les options de l'aide.
-hideClientAfterLaunchSessionLorsque cette option est définie sur true, la fenêtre de sélection des postes de travail et des applications est masquée. Lorsqu'elle est définie sur false, la fenêtre de sélection des postes de travail et des applications s'affiche.

Remarque : si -appName ou -desktopName sont utilisés, Horizon Client masque toujours la fenêtre de sélection avec ou sans -hideClientAfterLaunchSession.

-installShortcutsThenQuitUtilisez cette option pour installer des raccourcis de poste de travail et d'application qui sont configurés sur le serveur. Lorsque vous utilisez cette option avec des informations d'authentification de serveur suffisantes, Horizon Client se connecte au serveur en mode silencieux, installe les raccourcis, puis se ferme. Si l'authentification du serveur échoue, Horizon Client se ferme en mode silencieux. Pour installer automatiquement des raccourcis sur le système client, créez un script qui s'exécute lors du démarrage du système client. Par exemple :
[executable] -serverURL serverurl -userName user -domainName domain 
-password password -installShortcutsThenQuit

[executable] -serverURL serverurl -logInAsCurrentUser true -installShortcutsThenQuit

Pour plus d'informations sur les raccourcis créés par le serveur, reportez-vous à la section Configurer les mises à jour de raccourcis sur Horizon Windows Client.
-languageId Locale_IDAssure la localisation de différentes langues dans Horizon Client. Si une bibliothèque de ressources est disponible, spécifiez l'ID de paramètre local (LCID) à utiliser. Pour l'anglais US, saisissez la valeur 0x409.
-launchMinimizedDémarre Horizon Client en mode réduit. Si vous indiquez l'option -appName ou -desktopName, Horizon Client reste réduit jusqu'au démarrage de l'application publiée ou du poste de travail distant spécifié. Vous ne pouvez pas utiliser cette option avec l'option -unattended ou -nonInteractive.
-listMonitorsRépertorie les valeurs d'index et les informations de disposition de l'affichage des moniteurs connectés. Par exemple :
1: (0, 0, 1920, 1200)
2: (1920, 0, 3840, 1200)
3: (-900, -410, 0, 1190)
Vous pouvez utiliser ces valeurs d'index dans l'option -monitors.
--lockUserNameVerrouille le nom d'utilisateur fourni pour la connexion au serveur. Cette option peut être utilisée uniquement lorsque vous spécifiez l'adresse du serveur. Utilisez cette option pour verrouiller le champ Nom d'utilisateur pour le type d'authentification Active Directory.
-logInAsCurrentUserLorsque cette valeur est définie sur true, les informations d'identification que l'utilisateur final fournit lors de l'ouverture de session sur le système client pour se connecter au serveur, puis au poste de travail distant, sont utilisées. La valeur par défaut est false.
-machineName machine_nameEnvoie au serveur le RDSH ou le nom de domaine complet de la machine pour lancer une application ou un poste de travail sur la machine. Cette option ne s'applique que lorsque le paramètre Autoriser la sélection d'un nom de machine est activé sur le pool ou la batterie de serveurs. Nécessite également la spécification des options -desktopName, -appName et -serverURL pour s'appliquer.
-monitors"n[,n,n,n]"Spécifie les moniteurs à utiliser dans une configuration à plusieurs moniteurs, où n est la valeur d'index d'un moniteur. Vous pouvez utiliser l'option -listMonitors pour déterminer les valeurs d'index des moniteurs connectés. Vous pouvez spécifier jusqu'à quatre valeurs d'index, séparées par des virgules. Par exemple :
-monitors "1,2"
Cette option n'a pas d'effet tant que -desktopLayout n'est pas défini sur multimoniteur.
-nonInteractiveSupprime des zones de messages d'erreur lors du démarrage d'Horizon Client à partir d'un script. Cette option est implicitement définie si vous spécifiez l'option -unattended. Remarque : si vous vous connectez à un serveur en mode non interactif, vous n'êtes pas invité à installer les raccourcis du menu Démarrer (le cas échéant), et des raccourcis sont installés par défaut.
Mot de passe -passwordSpécifie le mot de passe que l'utilisateur final utilise pour ouvrir une session sur Horizon Client. La console de commande ou tout outil de script traite le mot de passe en texte brut. Si vous générez le mot de passe automatiquement, il est inutile de spécifier cette option pour les clients en mode Kiosque. Pour améliorer la sécurité, ne spécifiez pas cette option. Les utilisateurs peuvent entrer le mot de passe de façon interactive.
-printEnvironmentInfoAffiche l'adresse IP, l'adresse MAC et le nom de machine du périphérique client.
-serverURL connection_serverSpécifie l'URL, l'adresse IP ou le nom de domaine complet du serveur.
-shutdownArrête tous les postes de travail distants et applications publiées et les composants d'interface utilisateur pertinents.
-singleAutoConnectSi l'utilisateur est autorisé à accéder uniquement à un seul poste de travail distant ou à une seule application publiée, il s'y connecte après s'être authentifié sur le serveur. Ce paramètre permet à l'utilisateur de ne pas sélectionner un poste de travail distant ou une application publiée dans une liste contenant un seul élément.
Code PIN -smartCardPINSpécifie le code PIN lorsqu'un utilisateur final insère une carte à puce pour ouvrir une session.
-usernameHint user_nameSpécifie le nom de compte à utiliser comme aide-mémoire du nom d'utilisateur.
-standaloneDémarre une deuxième instance d'Horizon Client qui peut se connecter au même serveur ou à un autre serveur. Cette option est prise en charge pour la compatibilité en amont. Il n'est pas nécessaire de spécifier le paramètre -standalone, car il s'agit du comportement par défaut du client. Pour plusieurs connexions de poste de travail distant au même serveur ou à un autre serveur, l'utilisation du tunnel sécurisé est prise en charge. Remarque : la deuxième connexion de poste de travail peut ne pas avoir accès au matériel local, tel que les périphériques USB, les cartes à puce, les imprimantes et les écrans multiples.
-supportText file_nameSpécifie le chemin d'accès complet d'un fichier texte. Le contenu du fichier s'affiche dans la boîte de dialogue À propos.
-unattendedDémarre Horizon Client dans un mode non interactif approprié aux clients en mode Kiosque. Vous devez également spécifier les informations suivantes :
  • Le nom de compte du client, si vous n'avez pas généré le nom de compte à partir de l'adresse MAC du périphérique client. Le nom doit commencer par la chaîne de caractères « custom- » ou par un autre préfixe que vous avez configuré dans ADAM.
  • Le mot de passe du client, si vous n'avez pas généré un mot de passe automatiquement lorsque vous avez configuré le compte pour le client.
L'option -unattended définit implicitement les options -nonInteractive, -connectUSBOnStartup, -connectUSBOnInsert et -desktopLayout multimoniteur.
-unauthenticatedAccessAccountSpécifie un compte d'utilisateur Accès non authentifié à utiliser pour se connecter de manière anonyme au serveur lorsque l'accès non authentifié est activé. Si l'accès non authentifié n'est pas activé, cette option est ignorée. Par exemple :
[executable] -serverURL horizon.mycompany.com 
-unauthenticatedAccessEnabled true 
-unauthenticatedAccessAccount anonymous1
-unauthenticatedAccessEnabled Lorsque cette valeur est définie sur true, l'accès non authentifié est autorisé. Si l'accès non authentifié n'est pas disponible, le client peut revenir à une autre méthode d'authentification. Le paramètre Accès non authentifié est affiché, désactivé et sélectionné dans Horizon Client. Lorsque cette valeur est définie sur false, vous devez saisir vos informations d'identification pour vous connecter à vos applications et y accéder. Le paramètre Accès non authentifié est masqué et désélectionné dans Horizon Client. Si vous ne spécifiez pas cette option, vous pouvez activer l'accès non authentifié dans Horizon Client. Le paramètre Accès non authentifié est affiché, activé et désélectionné.
-useExistingCette option vous permet de lancer plusieurs applications publiées et postes de travail distants à partir d'une seule session Horizon Client. Lorsque vous spécifiez cette option, Horizon Client détermine si une session avec les mêmes nom d'utilisateur, domaine et URL de serveur existe déjà et, si c'est le cas, réutilise cette session au lieu d'en créer une. Par exemple, dans la commande suivante, user-1 démarre l'application Calculatrice et une session est créée.
[executable] -userName user-1 -password secret 
-domainName domain -appName Calculator 
-serverURL horizon.mycompany.com -useExisting
Dans la commande suivante, user1 démarre l'application Paint avec les mêmes nom d'utilisateur, domaine et URL de serveur, et la même session est utilisée.
[executable] -userName user-1 -password secret 
-domainName domain -appName Paint 
-serverURL horizon.mycompany.com -useExisting
-userName user_nameSpécifie le nom de compte que l'utilisateur final utilise pour ouvrir une session sur Horizon Client. Si vous générez le nom du compte de l'adresse MAC du périphérique client, vous n'avez pas besoin spécifier cette option pour les clients en mode Kiosque.

Vous pouvez spécifier toutes les options par des stratégies de groupe Active Directory, à l'exception de -file, -languageId, -printEnvironmentInfo, -smartCardPIN et -unattended.

Remarque : les paramètres de stratégie de groupe prévalent sur ceux spécifiés dans la ligne de commande. Les options de ligne de commande sont sensibles à la casse.

Fichier de configuration d'Horizon Client

Vous pouvez consulter les options de ligne de commande pour Horizon Client dans un fichier de configuration.

Vous pouvez spécifier le chemin du fichier de configuration comme argument de l'option file_path -file de la commande exécutable. Le fichier doit être un fichier texte Unicode (UTF-16) ou ASCII.

Exemple de fichier de configuration pour une application non interactive

L'exemple suivant montre le contenu d'un fichier de configuration pour une application non interactive.

-serverURL https://horizon.yourcompany.com
-userName autouser
-password auto123
-domainName companydomain
-desktopName autodesktop
-nonInteractive

Exemple de fichier de configuration pour un client en mode Kiosque

L'exemple suivant montre un client en mode Kiosque dont le nom de compte est basé sur son adresse MAC. Le client a un mot de passe généré automatiquement.

-serverURL 145.124.24.100
-unattended

Cette page vous a-t-elle été utile ?

Envoyer un commentaire sur cette rubrique

Cette rubrique vous a-t-elle été utile ?

N'indiquez aucune information personnelle ou confidentielle.

Génération du lien…