Documentation produit
Gestion de l'environnement de travail 2407
Service Current Release 2402 2311 2308 2305 2303 2212 2209 2206 2203
Voir PDF

Jetons dynamiques

December 11, 2024
Contributeur: 
C

Vous pouvez utiliser des jetons dynamiques dans n’importe quelle action de gestion de l’environnement de l’espace de travail pour les rendre plus puissants.

Vous pouvez utiliser des jetons dynamiques dans les domaines suivants :

  • Paramètres de stratégie de groupe

    • Avec Action définie sur Supprimer la valeur : Valeur
    • Avec Action définie sur Définir la valeur et Type défini sur REG_SZ : Valeur, Données
    • Avec Action définie sur Définir la valeur et Type défini sur REG_EXPAND_SZ : Valeur, Données
    • Avec Action définie sur Définir la valeur et Type défini sur REG_MULTI_SZ : Valeur, 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. Voir Prise en charge des jetons dynamiques 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 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 :

  • Réglages utilisateur. Ces paramètres s’appliquent uniquement aux utilisateurs, quelle que soit la machine sur laquelle ils se connectent.
  • Réglages de la machine Ces paramètres s’appliquent uniquement aux machines, quelle que soit la personne qui y ouvre une session. 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 éléments suivants ne sont pas pris en charge pour les paramètres de la machine.

  • Hashtags

    • ##Nom d’utilisateur complet##
    • ##Initiales de l’utilisateur##
    • ##Nom du client##
    • ##Adresse IP du client##
    • ##UserLDAPPath##
    • ##ClientRemoteOS##
  • Attribut AD
    • [ADAttribute:attrName]
    • [UserParentOU: niveau]
  • Registres sous HKCU

Applications

  • Avec 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

  • Chemin cible

Disques réseau

  • Chemin cible et Nom d’affichage

Disques virtuels

  • Chemin cible

Registres

  • Chemin cible, Nom de la cibleet Valeur 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

  • Cible du port

Fichiers ini

  • Chemin cible, Section cible, Nom de la valeur cible, et Valeur cible

Remarque :

Les champs Section cible, Nom de la valeur cibleet 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 du système de fichiers

  • Chemin source et Chemin cible

Certaines conditions de filtrage

  • Exemple : avec Active Directory Attribute Match* 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, voir Matrice de prise en charge pour les 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 :

Modal Description Exemple 
#Gauche(chaîne,longueur)# Renvoie le nombre spécifié de caractères à gauche. #Gauche(abcdef,2)# renvoie ab
#Droite(chaîne,longueur)# Renvoie le nombre spécifié de caractères à droite. #Droite(abcdef,2)# renvoie ef
#Tronquer(chaîne,longueur)# 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 spécifié de caractères à gauche. #Tronquer(abcdef,3)# renvoie abc
&Trim(chaîne)& Supprime tous les espaces vides de début et de fin de la chaîne. &Trim( abc )& renvoie abc
&RemoveSpaces(chaîne)& Supprime tous les espaces vides de la chaîne. &RemoveSpaces( abc )& renvoie abc
&Développer(chaîne)& Si la chaîne contient une variable d’environnement entourée de \%, développe la variable. &Développer(%userprofile%\destop)& renvoie C:\Users\Jill\desktop
$Split(chaîne, séparateur],index)$ Divise la chaîne en sous-chaînes en fonction du séparateur entouré de [] et renvoie la sous-chaîne indexée. $Split(abc-def-hij,[-],2)$ renvoie hij
#Mid(chaîne,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(chaîne,startindex,longueur)! 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(chaîne,startindex,longueur)! Commence à l’index spécifié dans la chaîne et renvoie le nombre de caractères spécifié. !Sous-chaîne(abcdef,1,2)! renvoie bc
#Mod(chaîne, longueur)# 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 avec les hashtags et les attributs Active Directory. Par exemple : #Left([ADAttribute:NAME],2)# où l’attribut de nom de l’utilisateur actuel du domaine est Administrator renvoie Adet $Split(##ClientIPAddress##,[\.],2)$ renvoie 157.
  • !Mid(chaîne,startindex,longueur)! et !Substring(chaîne,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 de gestion de l’environnement de l’espace de travail. 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 souhaiterez peut-être écrire %UserName% littéralement, ou écrire la valeur développée.

Pour augmenter la flexibilité, ##UserName## existe sous forme de hashtag, de sorte que l’utilisation de %UserName% pour une valeur l’écrit littéralement et ##UserName## écrit la valeur développée.

Voir le tableau suivant pour des exemples :

Modal Description Exemple 
##Nom d’utilisateur## Renvoie la variable d’environnement développée “%username%” Jill
##Profil d’utilisateur## Renvoie la variable d’environnement développée “%userprofile%” C:\Utilisateurs\Jill
##Nom d’utilisateur complet## Renvoie le nom complet de l’utilisateur dans Active Directory Jill Chou
##Initiales de l’utilisateur## Renvoie les initiales du nom d’utilisateur dans Active Directory JC
##Données d’application utilisateur## Renvoie le chemin réel du dossier spécial - RoamingAppData C:\Users\Jill\AppData\Ren déplacement
##UtilisateurPersonnel## Renvoie le chemin réel du dossier spécial - Documents C:\Users\Jill\Documents
##Documents utilisateur## Renvoie le chemin réel du dossier spécial - Documents C:\Users\Jill\Documents
##UtilisateurDesktop## Renvoie le chemin réel du dossier spécial - Bureau C:\Users\Jill\Desktop
##Favoris de l’utilisateur## Renvoie le chemin réel du dossier spécial - Favoris C:\Users\Jill\Favoris
##Modèles d’utilisateur## Renvoie le chemin réel du dossier spécial - Modèles C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Tmodèles
##Menu de démarrage de l’utilisateur## Renvoie le chemin réel du dossier spécial - StartMenu C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Menu Démarrer
##Programmes du menu de démarrage utilisateur## Renvoie le chemin réel du dossier spécial - Programmes C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Menu Démarrer\Programmes
##Données d’application locales de l’utilisateur## Renvoie le chemin réel du dossier spécial - LocalAppData C:\Users\Jill\AppData\Local
##MusiqueUtilisateur## Renvoie le chemin réel du dossier spécial - Musique C:\Users\Jill\Musique
##Images d’utilisateur## Renvoie le chemin réel du dossier spécial - Images C:\Users\Jill\Images
##Vidéos d’utilisateurs## Renvoie le chemin réel du dossier spécial - Vidéos C:\Users\Jill\Vidéos
##Téléchargements utilisateur## Renvoie le chemin réel du dossier spécial - Téléchargements C:\Users\Jill\Téléchargements
##Liens utilisateur## Renvoie le chemin réel du dossier spécial - Liens C:\Users\Jill\Liens
##Contacts de l’utilisateur## Renvoie le chemin réel du dossier spécial - Contacts C:\Utilisateurs\Jill\Contacts
##Recherches d’utilisateurs## Renvoie le chemin réel du dossier spécial - SavedSearches C:\Users\Jill\Recherches
##programmes communs## Renvoie le chemin réel du dossier spécial - CommonPrograms C:\ProgramData\Microsoft\Windows\Menu Démarrer\Programmes
##Nom de l’ordinateur## Renvoie le nom de la machine WIN10EN-LR3B66L
##Nom du client## Renvoie le nom de la machine cliente W2K16ST-5IS28JP
##Adresse IP du client## Renvoie l’adresse IP de la machine cliente 10.150.153.138
##Adresse IP## Renvoie l’adresse IP de la machine 10.150.153.213
##Site publicitaire## Renvoie le site Active Directory dont la machine est membre NKG
##Valeur d’enregistrement par défaut## - Toujours chaîne.Vide
##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\Agent de gestion de l’environnement Workspace
##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 Fenêtres
##Informations sur le système d’exploitation du client## Renvoie les informations du système d’exploitation de la machine Windows 10 Entreprise 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’il est inclus, un champ de commentaire situé sous la capture d’écran dans l’utilitaire de capture d’écran de l’agent est présenté aux utilisateurs. Le commentaire est inclus dans l’e-mail d’assistance à l’emplacement où vous avez placé la balise dans le modèle d’e-mail.

Attributs Active Directory

Pour travailler avec 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. Il existe un filtre associé qui vérifie la valeur des attributs spécifiés.

Pour les structures d’unité organisationnelle (OU) utilisateur, WEM remplace la valeur [UserParentOU:level] par le nom de l’UO Active Directory associée. Le chemin Active Directory est le chemin 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 appartiennent les utilisateurs. Vous pouvez utiliser le jeton dynamique [UserParentOU:level] dans le chemin du lecteur réseau pour résoudre l’UO des utilisateurs de manière dynamique. Il existe deux façons 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 OU, puis définissez sa valeur sur [UserParentOU:0]. Vous pouvez ensuite mapper le lecteur comme \\Server\Share\%OU%\.

Remarque :

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

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’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]. Il n’existe aucun 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##.

Voir le tableau suivant pour des exemples :

Modal Description Exemple   
[ADAttribute:attrName] Renvoie l’attribut spécifié de l’utilisateur du domaine [ADAttribute:name] renvoie Administrateur  
[Attribut d’imprimante : nom d’imprimante\ [nom d’attribut] Renvoie l’attribut spécifié de l’imprimante de domaine spécifiée [PrinterAttribute:printer1|name] renvoie printer1
[UserParentOU: niveau] Renvoie le niveau spécifié de l’UO parent de l’utilisateur actuel [UserParentOU:1] dans CN=Jill Chou,OU=Comptes utilisateurs,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 :

  • [RegistryValue:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nrépertoire\Agent Host\AgentLocation]

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 résout un chemin. Vous devez entourer la variable d’environnement avec %. Par exemple, vous pouvez spécifier la valeur suivante :

  • [GetXmlValue:C:\citrix\test.xml|summary] ou
  • [GetXmlValue:%xmlpath%|résumé]

Fichiers INI

Pour travailler avec un fichier .ini, WEM remplace [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 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] ou
  • [GetIniValue:%inipath%|PLD_POOL_LIC_NODE_0_0|LicExpTime]

Informations supplémentaires

Matrice de prise en charge des conditions de filtrage

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 du nom de la batterie de serveurs XenApp - Oui
Correspondance du nom de la zone XenApp - Oui
Correspondance du nom de la batterie de serveurs XenDesktop - Oui
Correspondance des noms de groupes de bureaux 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 de nom de batterie de serveurs XenApp - Oui
Aucune correspondance de nom de zone XenApp - Oui
Aucune correspondance de nom de batterie de serveurs 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 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
December 11, 2024
Contributeur: 
C
December 11, 2024
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.