Workspace Environment Management

Jetons Dynamiques

Vous pouvez utiliser des jetons dynamiques dans n’importe quelle action Workspace Environment Management pour les rendre plus puissants.

Vous pouvez utiliser des jetons dynamiques dans les champs suivants :

  • Paramètres de stratégie de groupe

    • Avec l’action définie sur Supprimer la valeur : Valeur
    • Avec l’action définie sur Définir la valeur et le type défini sur REG_SZ : Données
    • Avec l’action définie sur Définir la valeur et le type défini sur REG_EXPAND_SZ : Données
    • Avec l’action définie sur Définir la valeur et le type défini sur REG_MULTI : Données

Remarque :

Les paramètres de stratégie de groupe sont de deux types : les paramètres de la machine et les paramètres utilisateur. Pour les paramètres de la machine, certains jetons dynamiques ne sont pas pris en charge. Consultez la section Prise en charge dynamique des jetons pour les paramètres de stratégie de groupe.

Prise en charge dynamique des jetons pour les paramètres de stratégie de groupe

L’utilisation de jetons dynamiques dans les paramètres de stratégie de groupe permet de configurer les politiques de manière plus adaptable dans différents environnements, de réduire la configuration manuelle et de simplifier la gestion des politiques.

Les paramètres de stratégie de groupe sont de deux types :

  • Réglages de la machine Ces paramètres s’appliquent uniquement aux machines, quelle que soit la personne qui y ouvre une session.
  • Réglages utilisateur. Ces paramètres s’appliquent uniquement aux utilisateurs, quelle que soit la machine sur laquelle ils se connectent.

Tous les jetons dynamiques sont pris en charge pour les paramètres de stratégie de groupe. Les paramètres suivants ne sont pas pris en charge pour les paramètres de la machine.

  • Hashtags

    • ##FullUserName##
    • ##UserInitials##
    • ##ClientName##
    • ##ClientIPAddress##
    • ##UserLDAPPath##
    • ##ClientRemoteOS##
  • Attribut AD
    • [ADAttribute:attrName]
    • [UserParent ou : 1]
  • Registres sous HKCU

  • Applications
    • Avec l’application d’installation comme type d’application : ligne de commande, répertoire de travailet paramètres
    • Avec Fichier/Dossier comme type d’application : Cible
    • Avec URL comme type d’application : URL de raccourci
    • Fichier d’icônes
  • Imprimantes
    • Trajectoire cible
  • Disques réseau
    • Chemin cible et nom d’affichage
  • Disques virtuels
    • Trajectoire cible
  • Registres
    • Chemin cible, nom de la cibleet valeur de la cible

    Remarque :

    Le champ Valeur cible ne prend pas en charge l’extension des variables d’environnement. Si vous utilisez des variables d’environnement, elles ne fonctionnent pas comme prévu.

  • Variables d’environnement
    • Valeur variable
  • Ports
    • Port cible
  • Fichiers Ini
    • Chemin cible, section cible, nom de la valeur cible et valeur cible

    Remarque :

    La section Cible, le nom de la valeur cibleet les champs de valeur cible ne prennent pas en charge l’extension des variables d’environnement. Si vous utilisez des variables d’environnement, elles ne fonctionnent pas comme prévu.

  • Tâches externes
    • Parcours et arguments
  • Opérations du système de fichiers
    • Chemin source et chemin cible
  • Certaines conditions de filtre
    • Exemple : avec Active Directory Attribute Match comme type de condition : attribut Active Directory testé et résultat correspondant

    Remarque :

    Pour obtenir la liste complète des champs pris en charge pour les conditions de filtre, consultez la matrice de prise en charge des conditions de filtre.

Opérations de chaîne

Il est parfois nécessaire de 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 de Workspace Environment Management :

Modal Description Exemple
#Left(string,length)# Renvoie le nombre de caractères spécifié sur la gauche. #Left(abcdef,2)# renvoie ab
#Right(string,length)# Renvoie le nombre de caractères spécifié sur la 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é sur la 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 entourée de %, 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 qui est entouré de [] 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 le 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 de chaîne sont également prises en charge par des hashtags et des attributs Active Directory. Par exemple : #Left([ADAttribute:NAME],2)# où l’attribut name de l’utilisateur actuel du domaine est Administrator renvoyé Ad, et $Split(##ClientIPAddress##,[\.],2)$ renvoie 157.
  • !Mid(string,startindex,length)! et !Substring(string,startindex,length)! les opérations sont toujours effectuées en dernier.

Hashtags

Les hashtags sont une fonctionnalité de remplacement largement utilisée dans le traitement des éléments Workspace Environment Management. L’exemple suivant illustre la façon dont vous utilisez les hashtags :

Pour écrire dans un fichier .ini, vous pouvez utiliser%USERNAME% dans le chemin d’accès du fichier.ini et Workspace Environment Management le traite et étend le répertoire final. Toutefois, l’évaluation de la valeur écrite par Workspace Environment Management dans le .ini lui-même est plus compliquée : vous pouvez écrire littéralement %USERNAME% ou écrire la valeur développée.

Pour augmenter la flexibilité, # #UserName ## existe sous forme de hash-tag, 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 obtenir des exemples :

Modal Description Exemple
##UserName## Renvoie la variable d’environnement étendue « %username% » Jill
##UserProfile## Renvoie la variable d’environnement étendue « %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 réel du dossier spécial - RoamingAppData C:\Users\Jill\AppData\Roaming
##UserPersonal## Renvoie le chemin réel du dossier spécial - Documents C:\Users\Jill\Documents
##UserDocuments## Renvoie le chemin réel du dossier spécial - Documents C:\Users\Jill\Documents
##UserDesktop## Renvoie le chemin réel du dossier spécial - Desktop C:\Users\Jill\Desktop
##UserFavorites## Renvoie le chemin 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 - StartMenu Menu C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Start
##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
##commonprograms## 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## - Always string.Empty
##UserLDAPPath## Renvoie le nom distinctif de l’utilisateur actuel CN=Jill Chou, OU=comptes utilisateurs, 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 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 relatives au système d’exploitation de la machine Windows 10 Enterprise 64 bits

Le hash-tag ##UserScreenCaptureComment## est implémenté pour une utilisation 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. Une fois inclus, les utilisateurs sont affichés avec 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 d’assistance à l’endroit où vous avez placé la balise dans le modèle d’e-mail.

Attributs Active Directory

Pour utiliser les attributs Active Directory, WEM remplace la valeur [adAttribute:AttrName] par l’attribut Active Directory associé. [adAttribute:AttrName] est le jeton dynamique pour tous les attributs Active Directory. Un filtre associé vérifie la valeur des attributs spécifiés.

Pour les structures d’unités organisationnelles (OU) utilisateur, WEM remplace la valeur [UserParentOU:Level] par le nom d’unité d’organisation Active Directory associée. Le chemin d’accès Active Directory est le chemin d’accès utilisateur complet (LDAP) dans Active Directory et [UserParentou:Level] en est un sous-ensemble.

Par exemple, supposons que vous souhaitiez créer un lecteur réseau pour une unité d’organisation à laquelle les utilisateurs appartiennent. Vous pouvez utiliser le jeton dynamique [UserParentOu:Level] dans le chemin du lecteur réseau pour résoudre dynamiquement l’unité d’organisation des utilisateurs. Il existe deux manières d’utiliser le jeton dynamique :

  • Utilisez le jeton dynamique [UserParentOU:Level] directement dans le chemin du lecteur réseau. Par exemple, vous pouvez utiliser le chemin suivant : \\Server\Share\[UserParentOU:0]\.
  • Définissez une variable d’environnement appelée UO, puis définissez sa valeur sur [UserParentOu:0]. Vous pouvez ensuite cartographier le lecteur en tant que \\Server\Share\%OU%\.

Remarque :

  • Vous pouvez remplacer le chiffre « 0 » par le chiffre correspondant au niveau que vous souhaitez atteindre dans la structure de l’unité d’organisation.
  • Vous pouvez ajouter des variables au chemin d’accès. Pour ce faire, assurez-vous que vous disposez d’une structure de dossiers exacte qui correspond à la disposition de votre unité d’organisation.

Vous pouvez également utiliser des 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 condition de filtre suivants associés aux attributs Active Directory :

  • Correspondance d’attributs Active Directory
  • Correspondance de groupe Active Directory
  • Correspondance du chemin Active Directory
  • Correspondance de site Active Directory

Pour la correspondance d’attributs Active Directory, le jeton dynamique est [adAttribute:AttrName]. Aucun jeton dynamique n’est disponible pour Active Directory Group Match, car ce type de condition est utilisé pour vérifier l’appartenance à un groupe. Pour Active Directory Path Match, le jeton dynamique du chemin LDAP complet est # #UserLDAPPath ##. Pour Active Directory Site Match, le jeton dynamique est ##ADSite##.

Consultez le tableau suivant pour obtenir des exemples :

Modal Description Exemple
[ADAttribute:attrName] Renvoie l’attribut spécifié de l’utilisateur du 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 l’imprimante1
[UserParentOU: level] Renvoie le niveau spécifié de l’unité d’organisation parent de l’utilisateur actuel [UserParentOU:1] en CN=Jill Chou,OU=User Accounts,OU=APAC,DC=citrite,DC=net retour APAC

Registres

Pour utiliser 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 :

  • [RegistryValue:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host\AgentLocation]

fichiers XML

Pour utiliser 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 d’accès réel ou une variable d’environnement qui se résout en chemin. Vous devez entourer 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 utiliser un fichier .ini, WEM remplace le fichier [GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] par la valeur de clé. Le chemin INI peut être un chemin réel ou une variable d’environnement qui se résout en chemin. Vous devez entourer 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]

Informations supplémentaires

Matrice de compatibilité pour les conditions de filtration

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 entre les noms - Oui
Correspondance entre les noms - Oui
Correspondance entre les variables Non Oui
Correspondance de la valeur Oui Oui
Correspondance des résultats de la requête WMI - Oui
Correspondance des noms de batteries XenApp - Oui
Correspondance des noms de zone XenApp - Oui
Correspondance des noms de ferme XenDesktop - Oui
Correspondance des noms de groupes de postes de travail XenDesktop - Oui
Correspondance d’attributs Active Directory Oui Oui
Le nom ou la valeur figure dans la liste Oui Oui
Aucune correspondance de nom d’ordinateur - Oui
Aucune correspondance entre le nom du client - Oui
Aucune correspondance de variable d’environnement Non Oui
Aucune correspondance de valeur du registre Oui Oui
Aucun résultat de requête WMI Correspondance - Oui
Aucune correspondance entre le nom de la batterie de serveurs XenApp - Oui
Aucune correspondance entre les noms de zone XenApp - Oui
Aucune correspondance entre les noms de la ferme XenDesktop - Oui
Aucun nom de groupe de postes de travail XenDesktop ne correspond - Oui
Aucune correspondance d’attribut Active Directory Oui Oui
Le nom ou la valeur ne figurent pas dans la liste Oui Oui
Correspondance dynamique des valeurs Oui Oui
Aucune correspondance dynamique de valeur Oui Oui
Correspondance de la version 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 ne figure pas dans la liste Oui Oui
Le fichier/dossier existe - Oui
Le fichier/dossier n’existe pas - Oui
Jetons Dynamiques