Dynamische Token

Last published : Nov 13, 2026
Sie können dynamische Token in allen Workspace Environment Management Aktionen verwenden, um sie leistungsfähiger zu machen.
Sie können dynamische Token in den folgenden Feldern verwenden:
  • Gruppenrichtlinieneinstellungen
    • Bei Aktion auf Löschen gesetzt: Wert
    • Wenn Aktion auf Wert festlegen und Typ auf REG_SZ: Wert, Daten festgelegt ist
    • Wenn Aktion auf Wert festlegen und Typ auf REG_erweitern_SZ: Wert, Daten festgelegt ist
    • Wenn Aktion auf Wert festlegen und Typ auf REG_MULTI_SZ: Wert, Daten festgelegt ist
Hinweis:
Gruppenrichtlinieneinstellungen gibt es in zwei Typen: Maschineneinstellungen und Benutzereinstellungen. Für Maschineneinstellungen werden einige dynamische Token nicht unterstützt. Siehe Unterstützung dynamischer Token für Gruppenrichtlinieneinstellungen.
Related information
Referenz

Unterstützung dynamischer Token für Gruppenrichtlinieneinstellungen

Die Verwendung dynamischer Token in Gruppenrichtlinieneinstellungen ermöglicht eine anpassungsfähigere Richtlinienkonfiguration in verschiedenen Umgebungen, reduziert die manuelle Konfiguration und vereinfacht die Richtlinienverwaltung.
Gruppenrichtlinieneinstellungen gibt es in zwei Typen:
  • Maschineneinstellungen. Diese Einstellungen gelten nur für Maschinen, unabhängig davon, wer sich an ihnen anmeldet.
  • Benutzereinstellungen. Diese Einstellungen gelten nur für Benutzer, unabhängig davon, an welcher Maschine sie sich anmelden.
Alle dynamischen Token werden für Gruppenrichtlinieneinstellungen unterstützt. Die folgenden werden für Maschineneinstellungen nicht unterstützt.
  • Hashtags
    • ##FullUserName##
    • ##UserInitials##
    • ##ClientName##
    • ##ClientIPAddress##
    • ##UserLDAPPath##
    • ##ClientRemoteOS##
  • ADAttribute
  • Registrierungseinträge unter HKCU

Anwendungen

  • Bei Installationsanwendung als Anwendungstyp: Befehlszeile, Arbeitsverzeichnis und Parameter
  • Bei Datei/Ordner als Anwendungstyp: Ziel
  • Bei URL als Anwendungstyp: Verknüpfungs-URL
  • Symboldatei

Drucker

  • Zielpfad

Netzwerklaufwerke

  • Zielpfad und Anzeigename

Virtuelle Laufwerke

  • Zielpfad

Registrierungen

  • Zielpfad, Zielname und Zielwert
Hinweis:
Das Feld Zielwert unterstützt keine Umgebungsvariablen-Erweiterung. Wenn Sie Umgebungsvariablen verwenden, funktionieren diese nicht wie erwartet.

Umgebungsvariablen

  • Variablenwert

Ports

  • Port-Ziel

INI-Dateien

  • Zielpfad, Zielabschnitt, Zielwertname und Zielwert
Hinweis:
Die Felder Zielabschnitt, Zielwertname und Zielwert unterstützen keine Umgebungsvariablen-Erweiterung. Wenn Sie Umgebungsvariablen verwenden, funktionieren diese nicht wie erwartet.

Externe Aufgaben

  • Pfad und Argumente

Dateisystemoperationen

  • Quellpfad und Zielpfad

Bestimmte Filterbedingungen

  • Beispiel: Bei *Active Directory-Attributübereinstimmung als Bedingungstyp: Getestetes Active Directory-Attribut und Übereinstimmendes Ergebnis
Hinweis:
Eine vollständige Liste der unterstützten Felder für Filterbedingungen finden Sie unter Supportmatrix für Filterbedingungen.

Zeichenfolgenoperationen

Manchmal müssen Sie Zeichenfolgen innerhalb eines Skripts bearbeiten, um Laufwerke zuzuordnen oder Anwendungen zu starten. Die folgenden Zeichenfolgenoperationen werden vom Workspace Environment Management™-Agenten akzeptiert:
Syntax Beschreibung Beispiel
#Left(string,length)# Gibt die angegebene Anzahl von Zeichen von links zurück. #Left(abcdef,2)# gibt ab zurück
#Right(string,length)# Gibt die angegebene Anzahl von Zeichen von rechts zurück. #Right(abcdef,2)# gibt ef zurück
#Truncate(string,length)# Wenn die Länge der Zeichenfolge kleiner oder gleich der angegebenen Länge ist, wird die gesamte Zeichenfolge zurückgegeben. Wenn die Länge der Zeichenfolge größer als die angegebene Länge ist, wird die angegebene Anzahl von Zeichen auf der linken Seite zurückgegeben. #Truncate(abcdef,3)# gibt abc zurück
&Trim(string)& Entfernt alle führenden und nachgestellten Leerzeichen der Zeichenfolge. &Trim( a b c )& gibt a b c zurück
&RemoveSpaces(string)& Entfernt alle Leerzeichen der Zeichenfolge. &RemoveSpaces( a b c )& gibt abc zurück
&erweitern(string)& Wenn die Zeichenfolge eine Umgebungsvariable enthält, die mit \% umschlossen ist, wird die Variable erweitert. &Expand(%userprofile%\destop)& gibt C:\Users\Jill\desktop zurück
\$Split(string, splitter],index)\$ Teilt die Zeichenfolge basierend auf dem Trennzeichen, das mit [] umschlossen ist, in Teilzeichenfolgen auf und gibt die indizierte Teilzeichenfolge zurück. $Split(abc-def-hij,[-],2)$ gibt hij zurück
#Mid(string,startindex)# Beginnt am angegebenen Index in der Zeichenfolge und gibt alle Zeichen danach zurück. #Mid(abcdef,2)# gibt cdef zurück
!Mid(string,startindex,length)! Beginnt am angegebenen Index in der Zeichenfolge und gibt die angegebene Anzahl von Zeichen zurück. !Mid(abcdef,1,2)! gibt bc zurück
!Substring(string,startindex,length)! Beginnt am angegebenen Index in der Zeichenfolge und gibt die angegebene Anzahl von Zeichen zurück. !Substring(abcdef,1,2)! gibt bc zurück
#Mod(string,length)# Dividiert die Zeichenfolge durch die Länge und gibt den Rest zurück. Die Zeichenfolge muss in eine Ganzzahl konvertierbar sein. #Mod(7,3)# gibt 1 zurück
Hinweis:
  • Zeichenfolgenoperationen werden auch mit Hashtags und Active Directory-Attributen unterstützt. Zum Beispiel: #Left([ADAttribute:NAME],2)#, wobei das Namensattribut des aktuellen Domänenbenutzers Administrator ist, gibt Ad zurück, und $Split(##ClientIPAddress##,[\.],2)$ gibt 157 zurück.
  • !Mid(string,startindex,length)!- und !Substring(string,startindex,length)!-Operationen werden immer zuletzt ausgeführt.

Hashtags

Hash-Tags sind eine Ersetzungsfunktion, die bei der Verarbeitung von Workspace Environment Management-Elementen häufig verwendet wird. Das folgende Beispiel veranschaulicht, wie Sie Hash-Tags verwenden:
Um in eine .ini-Datei zu schreiben, können Sie %UserName% im Pfad der .ini-Datei verwenden, und Workspace Environment Management verarbeitet dies und erweitert das endgültige Verzeichnis. Die Bewertung des Werts, den Workspace Environment Management in die .ini selbst schreibt, ist jedoch komplizierter: Sie möchten möglicherweise %UserName% wörtlich schreiben oder den erweiterten Wert schreiben.
Um die Flexibilität zu erhöhen, existiert ##UserName## als Hashtag, sodass die Verwendung von %UserName% für einen Wert diesen wörtlich schreibt und ##UserName## den erweiterten Wert schreibt.
Siehe die folgende Tabelle für Beispiele:
Modal Beschreibung Beispiel
##UserName## Gibt die erweiterte Umgebungsvariable „%username%“ zurück Jill
##UserProfile## Gibt die erweiterte Umgebungsvariable „%userprofile%“ zurück C:\Users\Jill
##FullUserName## Gibt den vollständigen Namen des Benutzers in Active Directory zurück Jill Chou
##UserInitials## Gibt die Initialen des Benutzernamens in Active Directory zurück JC
##UserAppData## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – RoamingAppData C:\Users\Jill\AppData\Roaming
##UserPersonal## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Dokumente C:\Users\Jill\Documents
##UserDocuments## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Dokumente C:\Users\Jill\Documents
##UserDesktop## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Desktop C:\Users\Jill\Desktop
##UserFavorites## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Favoriten C:\Users\Jill\Favorites
##UserTemplates## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Vorlagen C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Templates
##UserStartMenu## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Startmenü C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Start Menu
##UserStartMenuPrograms## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Programme C:\Users\Jill\AppData\Roaming\Microsoft\Windows\Start Menu\Programs
##UserLocalAppData## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – LocalAppData C:\Users\Jill\AppData\Local
##UserMusic## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Musik C:\Users\Jill\Music
##UserPictures## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Bilder C:\Users\Jill\Pictures
##UserVideos## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Videos C:\Users\Jill\Videos
##UserDownloads## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Downloads C:\Users\Jill\Downloads
##UserLinks## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Links C:\Users\Jill\Links
##UserContacts## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – Kontakte C:\Users\Jill\Contacts
##UserSearches## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – SavedSearches C:\Users\Jill\Searches
##allgemeine Programme## Gibt den tatsächlichen Pfad des speziellen Ordners zurück – CommonPrograms C:\ProgramData\Microsoft\Windows\Start Menu\Programs
##ComputerName## Gibt den Namen des Computers zurück WIN10EN-LR3B66L
##ClientName## Gibt den Namen des Clientcomputers zurück W2K16ST-5IS28JP
##ClientIPAddress## Gibt die IP-Adresse des Clientcomputers zurück 10.150.153.138
##IpAddress## Gibt die IP-Adresse des Computers zurück 10.150.153.213
##ADSite## Gibt die Active Directory-Site zurück, der der Computer angehört NKG
##DefaultRegValue## - Immer string.Empty
##UserLDAPPath## Gibt den Distinguished Name des aktuellen Benutzers zurück CN=Jill Chou,OU=User Accounts,OU=APAC,DC=citrite,DC=net
##VUEMAgentFolder## Gibt den Agent-Ordner zurück C:\Program Files (x86)\Citrix\Workspace Environment Management Agent
##RDSSessionID## Gibt die ID der Remotedesktopsitzung zurück 2
##RDSSessionName## Gibt den Namen der Remotedesktopsitzung zurück RDP-Tcp#72
##ClientRemoteOS## Gibt das Betriebssystem des Computers zurück, der für die Verbindung mit dem virtuellen Desktop verwendet wird Windows
##ClientOSInfos## Gibt die Betriebssysteminformationen des Computers zurück Windows 10 Enterprise 64-bit
Der Hash-Tag ##UserScreenCaptureComment## ist für die Verwendung in bestimmten Teilen des Produkts implementiert. Dieser Tag kann in der E-Mail-Vorlage unter Erweiterte Einstellungen > UI-Agent-Personalisierung > Helpdesk-Optionen eingefügt werden. Wenn er enthalten ist, wird den Benutzern ein Kommentarfeld unter dem Screenshot im Screenshot-Dienstprogramm des Agents angezeigt. Der Kommentar wird in die Support-E-Mail an der Stelle eingefügt, an der Sie den Tag in der E-Mail-Vorlage platziert haben.

Active Directory-Attribute

Um mit Active Directory-Attributen zu arbeiten, ersetzt WEM den Wert durch das zugehörige Active Directory-Attribut. ist das dynamische Token für beliebige Active Directory-Attribute. Es gibt einen zugehörigen Filter, der den Wert der angegebenen Attribute überprüft.
Für Benutzerorganisationseinheiten (OU)-Strukturen ersetzt WEM den Wert durch den zugehörigen Active Directory OU-Namen. Der Active Directory-Pfad ist der vollständige Benutzerpfad (LDAP) in Active Directory, und ist eine Untermenge davon.
Angenommen, Sie möchten beispielsweise ein Netzlaufwerk für eine OU erstellen, zu der die Benutzer gehören. Sie können das dynamische Token im Netzlaufwerkpfad verwenden, um die OU der Benutzer dynamisch aufzulösen. Es gibt zwei Möglichkeiten, das dynamische Token zu verwenden:
  • Verwenden Sie das dynamische Token direkt im Netzlaufwerkspfad. Zum Beispiel können Sie den folgenden Pfad verwenden: \\Server\Share\[UserParentOU:0]\.
  • Legen Sie eine Umgebungsvariable namens OU fest und setzen Sie deren Wert auf . Sie können das Laufwerk dann als \\Server\Share\%OU%\ zuordnen.
Hinweis:
  • Sie können die Ziffer „0“ durch die Zahl ersetzen, die der Ebene entspricht, die Sie in der OU-Struktur erreichen möchten.
  • Sie können Variablen an den Pfad anhängen. Stellen Sie dazu sicher, dass Sie eine exakte Ordnerstruktur haben, die Ihrem OU-Layout entspricht.
Sie können Active Directory-Attribute auch zu Filterzwecken verwenden. Auf der Registerkarte Administration > Filter > Bedingungen > Filterbedingungsliste können Sie das Fenster „Neue Filterbedingung“ öffnen, nachdem Sie auf Hinzufügen geklickt haben. Im Fenster „Neue Filterbedingung“ sehen Sie die folgenden vier Filterbedingungstypen, die mit Active Directory-Attributen verknüpft sind:
  • Active Directory-Attributübereinstimmung
  • Active Directory-Gruppenübereinstimmung
  • Active Directory-Pfadübereinstimmung
  • Active Directory-Standortübereinstimmung
Für die Active Directory-Attributübereinstimmung ist das dynamische Token . Für die Active Directory-Gruppenübereinstimmung ist kein dynamisches Token verfügbar, da dieser Bedingungstyp zur Überprüfung einer Gruppenmitgliedschaft verwendet wird. Für die Active Directory-Pfadübereinstimmung ist das dynamische Token für den vollständigen LDAP-Pfad ##UserLDAPPath##. Für die Active Directory-Standortübereinstimmung ist das dynamische Token ##ADSite##.
Beispiele finden Sie in der folgenden Tabelle:
Modal Beschreibung Beispiel
[ADAttribute:attrName] Gibt das angegebene Attribut des Domänenbenutzers zurück [ADAttribute:name] gibt Administrator zurück
[PrinterAttribute:printername|attrName] Gibt das angegebene Attribut des angegebenen Domänendruckers zurück [PrinterAttribute:printer1|name] gibt printer1 zurück
[UserParentOU: level] Gibt die angegebene Ebene der übergeordneten OU des aktuellen Benutzers zurück [UserParentOU:1] in CN=Jill Chou,OU=User Accounts,OU=APAC,DC=citrite,DC=net gibt APAC zurück

Registrierungen

Um mit einer Registrierung zu arbeiten, ersetzt WEM den Wert [RegistryValue:<Registry path>] durch den zugehörigen Registrierungswert. Sie können beispielsweise den folgenden Wert angeben:

XML-Dateien

Um mit einer XML-Datei zu arbeiten, ersetzt WEM den Wert [GetXmlValue:<XML path>|<tag name>] durch den spezifischen Tag-Wert in der XML-Datei. Der XML-Pfad kann ein tatsächlicher Pfad oder eine Umgebungsvariable sein, die zu einem Pfad aufgelöst wird. Sie müssen die Umgebungsvariable in % einschließen. Sie können beispielsweise den folgenden Wert angeben:
  • \[GetXmlValue:C:\citrix\test.xml\|summary\] oder
  • \[GetXmlValue:%xmlpath%\|summary\]

INI-Dateien

Um mit einer .ini-Datei zu arbeiten, ersetzt WEM [GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] durch den Schlüsselwert. Der INI-Pfad kann ein tatsächlicher Pfad oder eine Umgebungsvariable sein, die zu einem Pfad aufgelöst wird. Sie müssen die Umgebungsvariable in % einschließen. Sie können beispielsweise den folgenden Wert angeben:
  • \[GetIniValue:C:\citrix\test.ini\|PLD_POOL_LIC_NODE_0_0\|LicExpTime\] oder
  • \[GetIniValue:%inipath%\|PLD_POOL_LIC_NODE_0_0\|LicExpTime\]

Weitere Informationen

Unterstützungsmatrix für Filterbedingungen

Die folgende Tabelle listet alle Bedingungstypen auf, deren getesteter Wert oder passendes Ergebnis dynamische Token unterstützt.
Bedingungstyp Getesteter Wert Übereinstimmendes Ergebnis
Computername-Übereinstimmung - Ja
Clientname-Übereinstimmung - Ja
Umgebungsvariablen-Übereinstimmung Nein Ja
Registrierungswert-Übereinstimmung Ja Ja
WMI-Abfrageergebnis-Übereinstimmung - Ja
XenApp® Farmname-Übereinstimmung - Ja
XenApp Zonenname-Übereinstimmung - Ja
XenDesktop® Farmname-Übereinstimmung - Ja
XenDesktop Desktopgruppenname-Übereinstimmung - Ja
Active Directory-Attribut-Übereinstimmung Ja Ja
Name oder Wert ist in Liste Ja Ja
Keine Computername-Übereinstimmung - Ja
Keine ClientName-Übereinstimmung - Ja
Keine Übereinstimmung mit Umgebungsvariable Nein Ja
Keine Übereinstimmung mit Registrierungswert Ja Ja
Keine Übereinstimmung mit WMI-Abfrageergebnis - Ja
Keine Übereinstimmung mit XenApp-Farmname - Ja
Keine Übereinstimmung mit XenApp-Zonenname - Ja
Keine Übereinstimmung mit XenDesktop-Farmname - Ja
Keine Übereinstimmung mit XenDesktop-Desktopgruppenname - Ja
Keine Übereinstimmung mit Active Directory-Attribut Ja Ja
Name oder Wert ist nicht in der Liste Ja Ja
Übereinstimmung mit dynamischem Wert Ja Ja
Keine Übereinstimmung mit dynamischem Wert Ja Ja
Übereinstimmung mit Dateiversion Ja Ja
Keine Übereinstimmung mit Dateiversion Ja Ja
Name der veröffentlichten Ressource - Ja
Name ist in Liste Ja Ja
Name ist nicht in Liste Ja Ja
Datei/Ordner existiert - Ja
Datei/Ordner existiert nicht - Ja