Jetons dynamiques
Vous pouvez utiliser des jetons dynamiques dans toutes les actions de Workspace Environment Management pour les rendre plus puissantes.
Vous pouvez utiliser des jetons dynamiques dans les champs suivants :
-
Paramètres de stratégie de groupe
-
Lorsque Action est défini sur Delete value : Value
-
Lorsque Action est défini sur Set value et Type est défini sur REG_SZ: Value, Data
-
Lorsque Action est défini sur Set value et Type est défini sur REG_EXPAND_SZ: Value, Data
-
Lorsque Action est défini sur Set value et Type est défini sur REG_MULTI_SZ: Value, Data
-
Remarque :
Les paramètres de stratégie de groupe sont de deux types : les paramètres machine et les paramètres utilisateur. Pour les paramètres machine, certains jetons dynamiques ne sont pas pris en charge. Consultez Prise en charge des jetons dynamiques pour les paramètres de stratégie de groupe.
Prise en charge des jetons dynamiques pour les paramètres de stratégie de groupe
L'utilisation de jetons dynamiques dans les paramètres de stratégie de groupe permet une configuration de stratégie plus adaptable dans différents environnements, réduit la configuration manuelle et simplifie la gestion des stratégies.
Les paramètres de stratégie de groupe sont de deux types :
-
Paramètres machine. Ces paramètres s'appliquent uniquement aux machines, quel que soit l'utilisateur qui s'y connecte.
-
Paramètres utilisateur. Ces paramètres s'appliquent uniquement aux utilisateurs, quelle que soit la machine à laquelle ils se connectent.
Tous les jetons dynamiques sont pris en charge pour les paramètres de stratégie de groupe. Les suivants ne sont pas pris en charge pour les paramètres machine.
Applications
-
Avec Application d'installation comme type d'application : Ligne de commande, Répertoire de travail et Paramètres
-
Avec Fichier/Dossier comme type d'application : Cible
-
Avec URL comme type d'application : URL de raccourci
-
Fichier d'icône
Imprimantes
-
Chemin cible
Lecteurs réseau
-
Chemin cible et Nom d'affichage
Lecteurs virtuels
-
Chemin cible
Registres
-
Chemin cible, Nom cible et Valeur cible
Remarque :
Le champ Valeur cible ne prend pas en charge l'expansion des variables d'environnement. Si vous utilisez des variables d'environnement, elles ne fonctionneront pas comme prévu.
Variables d'environnement
-
Valeur de la variable
Ports
-
Cible de port
Fichiers Ini
-
Chemin cible, Section cible, Nom de la valeur cible et Valeur cible
Remarque :
Les champs Section cible, Nom de la valeur cible et Valeur cible ne prennent pas en charge l'expansion des variables d'environnement. Si vous utilisez des variables d'environnement, elles ne fonctionnent pas comme prévu.
Tâches externes
-
Chemin et Arguments
Opérations sur le système de fichiers
-
Chemin source et Chemin cible
Certaines conditions de filtre
-
Exemple : Avec *Correspondance d'attribut Active Directory comme type de condition : Attribut Active Directory testé et Résultat correspondant
Remarque :
Pour une liste complète des champs pris en charge pour les conditions de filtre, consultez Matrice de prise en charge des conditions de filtre.
Opérations sur les chaînes
Parfois, vous devez manipuler des chaînes dans un script pour mapper des lecteurs ou lancer des applications. Les opérations de chaîne suivantes sont acceptées par l'agent Workspace Environment Management™ :
| Fonction | Description | Exemple |
|---|---|---|
| #Left(string,length)# | Renvoie le nombre de caractères spécifié à gauche. | #Left(abcdef,2)# renvoie ab |
| #Right(string,length)# | Renvoie le nombre de caractères spécifié à droite. | #Right(abcdef,2)# renvoie ef |
| #Truncate(string,length)# | Si la longueur de la chaîne est inférieure ou égale à la longueur spécifiée, renvoie la chaîne entière. Si la longueur de la chaîne est supérieure à la longueur spécifiée, renvoie le nombre de caractères spécifié à gauche. | #Truncate(abcdef,3)# renvoie abc |
| &Trim(string)& | Supprime tous les espaces vides de début et de fin de la chaîne. | &Trim( a b c )& renvoie a b c |
| &RemoveSpaces(string)& | Supprime tous les espaces vides de la chaîne. | &RemoveSpaces( a b c )& renvoie abc |
| &Expand(string)& | Si la chaîne contient une variable d'environnement encadrée par \%, développe la variable. | &Expand(%userprofile%\destop)& renvoie C:\Users\Jill\desktop |
| \$Split(string, splitter],index)\$ | Divise la chaîne en sous-chaînes en fonction du séparateur encadré par [] et renvoie la sous-chaîne indexée. | $Split(abc-def-hij,[-],2)$ renvoie hij |
| #Mid(string,startindex)# | Commence à l'index spécifié dans la chaîne et renvoie tous les caractères qui suivent. | #Mid(abcdef,2)# renvoie cdef |
| !Mid(string,startindex,length)! | Commence à l'index spécifié dans la chaîne et renvoie le nombre de caractères spécifié. | !Mid(abcdef,1,2)! renvoie bc |
| !Substring(string,startindex,length)! | Commence à l'index spécifié dans la chaîne et renvoie le nombre de caractères spécifié. | !Substring(abcdef,1,2)! renvoie bc |
| #Mod(string,length)# | Divise la chaîne par la longueur et renvoie le reste. La chaîne doit pouvoir être convertie en entier. | #Mod(7,3)# renvoie 1 |
Remarque :
-
Les opérations sur les chaînes sont également prises en charge avec les hashtags et les attributs Active Directory. Par exemple :
#Left([ADAttribute:NAME],2)#où l'attribut de nom de l'utilisateur de domaine actuel estAdministratorrenvoieAd, et$Split(##ClientIPAddress##,[\.],2)$renvoie157. -
Les opérations
!Mid(string,startindex,length)!et!Substring(string,startindex,length)!sont toujours effectuées en dernier.
Hashtags
Les hashtags sont une fonctionnalité de remplacement largement utilisée dans le traitement des éléments de Workspace Environment Management. L'exemple suivant illustre comment utiliser les hashtags :
Pour écrire dans un fichier .ini, vous pouvez utiliser %UserName% dans le chemin du fichier .ini et Workspace Environment Management le traite et développe le répertoire final. Cependant, évaluer la valeur que Workspace Environment Management écrit dans le .ini lui-même est plus compliqué : vous pouvez vouloir écrire %UserName% littéralement, ou écrire la valeur développée.
Pour augmenter la flexibilité, ##UserName## existe en tant que hashtag, de sorte que l'utilisation de %UserName% pour une valeur l'écrit littéralement et ##UserName## écrit la valeur développée.
Consultez le tableau suivant pour des exemples :
| Modal | Description | Exemple |
|---|---|---|
| ##UserName## | Renvoie la variable d'environnement développée « %username% » | Jill |
| ##UserProfile## | Renvoie la variable d'environnement développée « %userprofile% » | C:\Users\Jill |
| ##FullUserName## | Renvoie le nom complet de l'utilisateur dans Active Directory | Jill Chou |
| ##UserInitials## | Renvoie les initiales du nom d'utilisateur dans Active Directory | JC |
| ##UserAppData## | Renvoie le chemin d'accès réel du dossier spécial - RoamingAppData | C:\Users\Jill\AppData\Roaming |
| ##UserPersonal## | Renvoie le chemin d'accès réel du dossier spécial - Documents | C:\Users\Jill\Documents |
| ##UserDocuments## | Renvoie le chemin d'accès réel du dossier spécial - Documents | C:\Users\Jill\Documents |
| ##UserDesktop## | Renvoie le chemin d'accès réel du dossier spécial - Bureau | C:\Users\Jill\Desktop |
| ##UserFavorites## | Renvoie le chemin d'accès réel du dossier spécial - Favoris | C:\Users\Jill\Favorites |
| ##UserTemplates## | Renvoie le chemin réel du dossier spécial - Modèles | C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Templates |
| ##UserStartMenu## | Renvoie le chemin réel du dossier spécial - Menu Démarrer | C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Start Menu |
| ##UserStartMenuPrograms## | Renvoie le chemin réel du dossier spécial - Programmes | C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Start Menu\Programs |
| ##UserLocalAppData## | Renvoie le chemin réel du dossier spécial - LocalAppData | C:\Users\Jill\AppData\Local |
| ##UserMusic## | Renvoie le chemin réel du dossier spécial - Musique | C:\Users\Jill\Music |
| ##UserPictures## | Renvoie le chemin réel du dossier spécial - Images | C:\Users\Jill\Pictures |
| ##UserVideos## | Renvoie le chemin réel du dossier spécial - Vidéos | C:\Users\Jill\Videos |
| ##UserDownloads## | Renvoie le chemin réel du dossier spécial - Téléchargements | C:\Users\Jill\Downloads |
| ##UserLinks## | Renvoie le chemin réel du dossier spécial - Liens | C:\Users\Jill\Links |
| ##UserContacts## | Renvoie le chemin réel du dossier spécial - Contacts | C:\Users\Jill\Contacts |
| ##UserSearches## | Renvoie le chemin réel du dossier spécial - SavedSearches | C:\Users\Jill\Searches |
| ##programmescommuns## | Renvoie le chemin réel du dossier spécial - CommonPrograms | C:\ProgramData\Microsoft\Windows\Start Menu\Programs |
| ##ComputerName## | Renvoie le nom de la machine | WIN10EN-LR3B66L |
| ##ClientName## | Renvoie le nom de la machine cliente | W2K16ST-5IS28JP |
| ##ClientIPAddress## | Renvoie l'adresse IP de la machine cliente | 10.150.153.138 |
| ##IpAddress## | Renvoie l'adresse IP de la machine | 10.150.153.213 |
| ##ADSite## | Renvoie le site Active Directory dont la machine est membre | NKG |
| ##DefaultRegValue## | - | Toujours string.Empty |
| ##UserLDAPPath## | Renvoie le nom distinctif de l'utilisateur actuel | CN=Jill Chou,OU=User Accounts,OU=APAC,DC=citrite,DC=net |
| ##VUEMAgentFolder## | Renvoie le dossier de l'agent | C:\Program Files (x86)\Citrix\Workspace Environment Management Agent |
| ##RDSSessionID## | Renvoie l'ID de la session de bureau à distance | 2 |
| ##RDSSessionName## | Renvoie le nom de la session de bureau à distance | RDP-Tcp#72 |
| ##ClientRemoteOS## | Renvoie le système d'exploitation de la machine utilisée pour se connecter au bureau virtuel | Windows |
| ##ClientOSInfos## | Renvoie les informations sur le système d'exploitation de la machine | Windows 10 Enterprise 64 bits |
Le hashtag ##UserScreenCaptureComment## est implémenté pour être utilisé dans des parties spécifiques du produit. Cette balise peut être incluse dans le modèle d'e-mail sous Paramètres avancés > Personnalisation de l'agent d'interface utilisateur > Options du service d'assistance. Lorsqu'elle est incluse, les utilisateurs se voient présenter un champ de commentaire situé sous la capture d'écran dans l'utilitaire de capture d'écran de l'agent. Le commentaire est inclus dans l'e-mail de support à l'emplacement où vous avez placé la balise dans le modèle d'e-mail.
Attributs Active Directory
Par exemple, supposons que vous souhaitiez créer un lecteur réseau pour une unité d'organisation (OU) à laquelle les utilisateurs appartiennent. Vous pouvez utiliser le jeton dynamique dans le chemin du lecteur réseau pour résoudre dynamiquement l'unité d'organisation des utilisateurs. Il existe deux façons d'utiliser le jeton dynamique :
Remarque :
-
Vous pouvez remplacer le chiffre « 0 » par le nombre qui correspond au niveau que vous souhaitez atteindre dans la structure de l'unité d'organisation.
-
Vous pouvez ajouter des variables au chemin. Pour ce faire, assurez-vous d'avoir une structure de dossiers exacte qui correspond à votre disposition d'unité d'organisation.
Vous pouvez également utiliser les attributs Active Directory à des fins de filtrage. Dans l'onglet Administration > Filtres > Conditions > Liste des conditions de filtre, vous pouvez ouvrir la fenêtre Nouvelle condition de filtre après avoir cliqué sur Ajouter. Dans la fenêtre Nouvelle condition de filtre, vous pouvez voir les quatre types de conditions de filtre suivants associés aux attributs Active Directory :
-
Correspondance d'attribut Active Directory
-
Correspondance de groupe Active Directory
-
Correspondance de chemin Active Directory
-
Correspondance de site Active Directory
Pour la correspondance d'attribut Active Directory, le jeton dynamique est . Il n'y a pas de jeton dynamique disponible pour la correspondance de groupe Active Directory, car ce type de condition est utilisé pour vérifier l'appartenance à un groupe. Pour la correspondance de chemin Active Directory, le jeton dynamique pour le chemin LDAP complet est ##UserLDAPPath##. Pour la correspondance de site Active Directory, le jeton dynamique est ##ADSite##.
Consultez le tableau suivant pour des exemples :
| Modal | Description | Exemple |
|---|---|---|
| [ADAttribute:attrName] | Renvoie l'attribut spécifié de l'utilisateur de domaine | [ADAttribute:name] renvoie Administrator |
| [PrinterAttribute:printername|attrName] | Renvoie l'attribut spécifié de l'imprimante de domaine spécifiée | [PrinterAttribute:printer1|name] renvoie printer1 |
| [UserParentOU: level] | Renvoie le niveau spécifié de l'unité d'organisation parente de l'utilisateur actuel | [UserParentOU:1] dans CN=Jill Chou,OU=User Accounts,OU=APAC,DC=citrite,DC=net renvoie APAC |
Registres
Pour travailler avec un registre, WEM remplace la valeur
[RegistryValue:<Registry path>] par la valeur de registre associée. Par exemple, vous pouvez spécifier la valeur suivante :
Fichiers XML
Pour travailler avec un fichier XML, WEM remplace la valeur
[GetXmlValue:<XML path>|<tag name>] par la valeur de balise spécifique dans le fichier XML. Le chemin XML peut être un chemin réel ou une variable d'environnement qui se résout en un chemin. Vous devez encadrer la variable d'environnement avec %. Par exemple, vous pouvez spécifier la valeur suivante :
-
\[GetXmlValue:C:\citrix\test.xml\|summary\] or
-
\[GetXmlValue:%xmlpath%\|summary\]
Fichiers INI
Pour travailler avec un fichier .ini, WEM remplace le
[GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] par la valeur de la clé. Le chemin INI peut être un chemin réel ou une variable d'environnement qui se résout en un chemin. Vous devez encadrer la variable d'environnement avec %. Par exemple, vous pouvez spécifier la valeur suivante :
-
\[GetIniValue:C:\citrix\test.ini\|PLD_POOL_LIC_NODE_0_0\|LicExpTime\] or
-
\[GetIniValue:%inipath%\|PLD_POOL_LIC_NODE_0_0\|LicExpTime\]
Plus d'informations
Matrice de prise en charge pour les conditions de filtre
Le tableau suivant répertorie tous les types de conditions dont la valeur testée ou le résultat correspondant prend en charge les jetons dynamiques.
| Type de condition | Valeur testée | Résultat correspondant |
|---|---|---|
| Correspondance NomOrdinateur | - | Oui |
| Correspondance du nom du client | - | Oui |
| Correspondance de la variable d'environnement | Non | Oui |
| Correspondance de la valeur de registre | Oui | Oui |
| Correspondance du résultat de la requête WMI | - | Oui |
| Correspondance du nom de la batterie XenApp® | - | Oui |
| Correspondance du nom de zone XenApp | - | Oui |
| Correspondance du nom de la batterie XenDesktop® | - | Oui |
| Correspondance du nom du groupe de bureaux XenDesktop | - | Oui |
| Correspondance de l'attribut Active Directory | Oui | Oui |
| Le nom ou la valeur est dans la liste | Oui | Oui |
| Aucune correspondance de nom d'ordinateur | - | Oui |
| Aucune correspondance de nom de client | - | Oui |
| Aucune correspondance de variable d'environnement | Non | Oui |
| Aucune correspondance de valeur de registre | Oui | Oui |
| Aucune correspondance de résultat de requête WMI | - | Oui |
| Aucune correspondance de nom de batterie XenApp | - | Oui |
| Aucune correspondance de nom de zone XenApp | - | Oui |
| Aucune correspondance de nom de batterie XenDesktop | - | Oui |
| Aucune correspondance de nom de groupe de bureaux XenDesktop | - | Oui |
| Aucune correspondance d'attribut Active Directory | Oui | Oui |
| Le nom ou la valeur n'est pas dans la liste | Oui | Oui |
| Correspondance de valeur dynamique | Oui | Oui |
| Aucune correspondance de valeur dynamique | Oui | Oui |
| Correspondance de version de fichier | Oui | Oui |
| Aucune correspondance de version de fichier | Oui | Oui |
| Nom de la ressource publiée | - | Oui |
| Le nom est dans la liste | Oui | Oui |
| Le nom n'est pas dans la liste | Oui | Oui |
| Le fichier/dossier existe | - | Oui |
| Le fichier/dossier n'existe pas | - | Oui |