Arbeitsplatzumgebungsmanagement 2407

Dynamische Token

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

    • Mit Aktion eingestellt auf Lösche Wert: Wert
    • Mit Aktion gesetzt auf Setze Wert und Typ gesetzt auf REG_SZ: Wert, Daten
    • Mit Aktion gesetzt auf Setze Wert und Typ gesetzt auf REG_EXPAND_SZ: Wert, Daten
    • Mit Aktion gesetzt auf Wert setzen und Typ gesetzt auf REG_MULTI_SZ: Wert, Daten

Hinweis:

Es gibt zwei Arten von Gruppenrichtlinieneinstellungen: Computereinstellungen und Benutzereinstellungen. Bei den Maschineneinstellungen werden einige dynamische Token nicht unterstützt. Siehe Dynamische Token-Unterstützung für Gruppenrichtlinieneinstellungen.

Dynamische Tokenunterstützung für Gruppenrichtlinieneinstellungen

Die Verwendung dynamischer Token in Gruppenrichtlinieneinstellungen ermöglicht eine anpassbarere Richtlinienkonfiguration in verschiedenen Umgebungen, reduziert die manuelle Konfiguration und vereinfacht die Richtlinienverwaltung.

Es gibt zwei Typen von Gruppenrichtlinieneinstellungen:

  • Einstellungen der Maschine. Diese Einstellungen gelten nur für Maschinen, unabhängig davon, wer sich bei ihnen anmeldet.
  • Benutzer-Einstellungen. Diese Einstellungen gelten nur für Benutzer, unabhängig davon, auf welchem Computer sie sich anmelden.

Für Gruppenrichtlinieneinstellungen werden alle dynamischen Token unterstützt. Die folgenden werden für Maschineneinstellungen nicht unterstützt.

  • Hashtags

    • ##VollständigerBenutzername##
    • ##Benutzerinitialen##
    • ##Kundenname##
    • ##ClientIPAdresse##
    • ##BenutzerLDAPPath##
    • ##ClientRemoteOS##
  • ADAttribute
    • [ADAttribute:attrName]
    • [UserParentOU: Ebene]
  • Register unter HKCU

Anwendungen

  • Mit Installationsanwendung als Anwendungstyp: Befehlszeile, Arbeitsverzeichnisund Parameter
  • Mit Datei/Ordner als Anwendungstyp: Ziel
  • Mit URL als Anwendungstyp: Verknüpfungs-URL
  • Symboldatei

Drucker

  • Zielpfad

Netzlaufwerke

  • Zielpfad und Anzeigename

Virtuelle Laufwerke

  • Zielpfad

Register

  • Zielpfad, Zielname, und Zielwert

Hinweis:

Das Feld Zielwert unterstützt keine Erweiterung von Umgebungsvariablen. Wenn Sie Umgebungsvariablen verwenden, funktionieren diese nicht wie erwartet.

Umgebungsvariablen

  • Variablenwert

Ports

  • Port Ziel

INI-Dateien

  • Zielpfad, Zielabschnitt, Zielwertnameund Zielwert

Hinweis:

Die Felder Zielabschnitt, Zielwertnameund Zielwert unterstützen keine Erweiterung von Umgebungsvariablen. Wenn Sie Umgebungsvariablen verwenden, funktionieren diese nicht wie erwartet.

Externe Aufgaben

  • Pfad und Argumente

Dateisystemvorgänge

  • Quellpfad und Zielpfad

Bestimmte Filterbedingungen

  • Beispiel: Mit Active Directory-Attributübereinstimmung* als Bedingungstyp: **Getestetes Active Directory-Attribut und Übereinstimmungsergebnis

Hinweis:

Eine vollständige Liste der unterstützten Felder für Filterbedingungen finden Sie unter Unterstützungsmatrix für Filterbedingungen.

Zeichenfolgenoperationen

Manchmal müssen Sie Zeichenfolgen in einem Skript bearbeiten, um Laufwerke zuzuordnen oder Anwendungen zu starten. Die folgenden Zeichenfolgenoperationen werden vom Workspace Environment Management-Agent akzeptiert:

Modal Beschreibung Beispiel
#Links(Zeichenfolge,Länge)# Gibt die angegebene Anzahl Zeichen auf der linken Seite zurück. #Links(abcdef,2)# gibt ab zurück
#Rechts(Zeichenfolge,Länge)# Gibt die angegebene Anzahl Zeichen auf der rechten Seite zurück. #Rechts(abcdef,2)# gibt zurück ef
#Abschneiden(Zeichenfolge,Länge)# 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 Zeichen auf der linken Seite zurückgegeben. #Truncate(abcdef,3)# gibt abc zurück
&Trim(Zeichenfolge)& Entfernt alle führenden und nachfolgenden Leerzeichen der Zeichenfolge. &Trim( abc )& gibt zurück abc
&RemoveSpaces(Zeichenfolge)& Entfernt alle Leerzeichen aus der Zeichenfolge. &RemoveSpaces( abc )& gibt zurück abc
&Expand(Zeichenfolge)& Wenn die Zeichenfolge eine Umgebungsvariable enthält, die mit \% umschlossen ist, wird die Variable erweitert. &Expand(%userprofile%\destop)& gibt zurück C:\Benutzer\Jill\desktop
$Split(Zeichenfolge, Splitter],Index)$ Teilt den String auf Basis des mit [] umschlossenen Splitters in Teilstrings auf und gibt den indizierten Teilstring zurück. $Split(abc-def-hij,[-],2)$ gibt hijzurück
#Mid(Zeichenfolge,Startindex)# Beginnt am angegebenen Index in der Zeichenfolge und gibt alle darauf folgenden Zeichen zurück. #Mid(abcdef,2)# gibt cdef zurück
!Mid(Zeichenfolge, Startindex, Länge)! Beginnt am angegebenen Index in der Zeichenfolge und gibt die angegebene Anzahl von Zeichen zurück. ! Mittel(abcdef,1,2)! Ertrag v. Chr
! Teilzeichenfolge(Zeichenfolge,Startindex,Länge)! Beginnt am angegebenen Index in der Zeichenfolge und gibt die angegebene Anzahl von Zeichen zurück. ! Teilzeichenfolge(abcdef,1,2)! Ertrag v. Chr
#Mod(Zeichenfolge,Länge)# Dividiert die Zeichenfolge durch die Länge und gibt den Rest zurück. Die Zeichenfolge muss in eine Ganzzahl konvertiert werden können. #Mod(7,3)# Ertrag 1

Hinweis:

  • Zeichenfolgenvorgänge werden auch mit Hashtags und Active Directory-Attributen unterstützt. Zum Beispiel: #Left([ADAttribute:NAME],2)# wobei das name-Attribut des aktuellen Domänenbenutzers Administrator Ertrag Inseratund $Split(##ClientIPAddress##,[\.],2)$ Ertrag 157.
  • ! Mitte(Zeichenfolge,Startindex,Länge)! und ! Teilzeichenfolge(Zeichenfolge,Startindex,Länge)! Operationen werden immer zuletzt ausgeführt.

Hashtags

Hashtags sind eine Ersatzfunktion, die bei der Verarbeitung von Workspace Environment Management-Elementen weit verbreitet ist. Das folgende Beispiel veranschaulicht, wie Sie Hashtags verwenden:

Um an eine .ini Datei können Sie %UserName% im .ini Der Pfad der Datei und Workspace Environment Management verarbeitet sie und erweitert das endgültige Verzeichnis. Wenn jedoch der Wert, den Workspace Environment Management in die .ini selbst ist komplizierter: Vielleicht möchten Sie %UserName% buchstäblich, oder schreiben Sie den erweiterten Wert.

Um die Flexibilität zu erhöhen, ##UserName#\ # als Hash-Tag existiert, so dass die Verwendung von %UserName% für einen Wert schreibt es wörtlich und ##UserName#\ # Schreibt den erweiterten Wert.

Beispiele finden Sie in der folgenden Tabelle:

Modal Beschreibung Beispiel
##UserName## Gibt die erweiterte Umgebungsvariable “%username%” Jill
##UserProfile## Gibt die erweiterte Umgebungsvariable “%userprofile%” C:\Benutzer\Jill
##VollständigerBenutzername## Gibt den vollständigen Namen des Benutzers in Active Directory zurück Jill Chou
##Benutzerinitialen## Gibt die Initialen des Benutzernamens in Active Directory zurück JC
##UserAppData## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - RoamingAppData C:\Benutzer\Jill\AppData\RTrocknen
##UserPersonal## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Dokumente C:\Benutzer\Jill\Dokumente
##UserDocuments## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Dokumente C:\Benutzer\Jill\Dokumente
##UserDesktop## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Desktop C:\Benutzer\Jill\Desktop
##UserFavorites## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Favoriten C:\Benutzer\Jill\Favoriten
##UserTemplates## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Vorlagen C:\Benutzer\Jill\AppData\RLesen\Microsoft\Windows\TPlatten
##UserStartMenu## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - StartMenu C:\Benutzer\Jill\AppData\Roaming\Microsoft\Windows\Startmenü
##UserStartMenuPrograms## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Programme C:\Benutzer\Jill\AppData\Roaming\Microsoft\Windows\Start Menu\Programme
##UserLocalAppData## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - LocalAppData C:\Benutzer\Jill\AppData\Lokal
##UserMusic## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Musik C:\Benutzer\Jill\Musik
##UserPictures## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Bilder C:\Benutzer\Jill\Bilder
##UserVideos## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Videos C:\Benutzer\Jill\Videos
##UserDownloads## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Downloads C:\Benutzer\Jill\Downloads
##UserLinks## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Links C:\Benutzer\Jill\Links
##UserContacts## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - Kontakte C:\Benutzer\Jill\Kontakte
##UserSearches## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - SavedSearches C:\Benutzer\Jill\Suchen
##commonprograms## Gibt den tatsächlichen Pfad des speziellen Ordners zurück - CommonPrograms C:\ProgramData\Microsoft\Windows\Startmenü\Programme
##ComputerName## Gibt den Namen des Computers zurück WIN10EN-LR3B66L
##Kundenname## Gibt den Namen des Clientcomputers zurück W2K16ST-5IS28JP
##ClientIPAdresse## Gibt die IP-Adresse des Client-Rechners zurück 10.150.153.138
##IpAddress## Gibt die IP-Adresse des Geräts zurück 10.150.153.213
##ADSite## Gibt den Active Directory-Standort zurück, an dem der Computer Mitglied ist NKG
##DefaultRegValue## - Immer Zeichenfolge. Leer
##BenutzerLDAPPath## Gibt den definierten Namen des aktuellen Benutzers zurück CN=Jill Chou,OU=Benutzerkonten,OU=APAC,DC=Citrit,DC=net
##VUEMAgentFolder## Gibt den Agentenordner zurück C:\Programme (x86)\Citrix\Workspace Environment Management Agent
##RDSSessionID## Gibt die Sitzungs-ID des Remotedesktops 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 Fenster
##ClientOSInfos## Gibt die Betriebssysteminformationen des Computers zurück Windows 10 Enterprise (64 Bit)

Hashtag ##UserScreenCaptureComment#\ # ist für den Einsatz in bestimmten Teilen des Produkts implementiert. Dieses Tag kann in die E-Mail-Vorlage unter Erweiterte Einstellungen > Personalisierung des UI-Agenten > Helpdesk-Optionen. Wenn enthalten, wird den Benutzern ein Kommentarfeld angezeigt, das sich unter der Bildschirmaufnahme im Agent-Bildschirmaufnahmeprogramm befindet. Der Kommentar wird in der Support-E-Mail an der Stelle eingefügt, an der Sie das Tag in der E-Mail-Vorlage platziert haben.

Active Directory-Attribute

Um mit Active Directory-Attributen zu arbeiten, ersetzt WEM die [ADAttribute:attrName] -Wert mit dem zugehörigen Active Directory-Attribut. [ADAttribute:attrName] ist das dynamische Token für alle Active Directory-Attribute. Es gibt einen zugehörigen Filter, der den Wert der angegebenen Attribute überprüft.

Bei den Strukturen der Benutzerorganisationseinheiten (OU) ersetzt WEM die [UserParentOU:Ebene] -Wert mit dem zugehörigen Active Directory-Organisationseinheitsnamen. Der Active Directory-Pfad ist der vollständige Benutzerpfad (LDAP) in Active Directory, und [UserParentOU:level] ist eine Teilmenge davon.

Angenommen, Sie möchten ein Netzlaufwerk für eine Organisationseinheit erstellen, zu der die Benutzer gehören. Sie können das dynamische Token [UserParentOU:level] im Pfad des Netzlaufwerks verwenden, um die Organisationseinheit der Benutzer dynamisch aufzulösen. Es gibt zwei Möglichkeiten, das dynamische Token zu verwenden:

  • Verwenden Sie das dynamische Token [UserParentOU:level] direkt im Pfad des Netzlaufwerks. Sie können z. B. den folgenden Pfad verwenden: ‘\Server\Share[UserParentOU:0]'.
  • Legen Sie eine Umgebungsvariable mit dem Namen OU fest, und legen Sie dann ihren Wert auf [UserParentOU:0] fest. Sie können das Laufwerk dann als ‘\Server\Share\%OU%`.

Hinweis:

  • Sie können die Ziffer “0” durch die Zahl ersetzen, die der Ebene entspricht, die Sie in der Organisationseinheitsstruktur erreichen möchten.
  • Sie können Variablen an den Pfad anhängen. Stellen Sie dazu sicher, dass Sie über eine genaue Ordnerstruktur verfügen, die Ihrem Organisationseinheitslayout entspricht.

Sie können Active Directory-Attribute auch zu Filterzwecken verwenden. Am Verwaltung > Filter > Bedingungen > Bedingungsliste filtern können Sie das Fenster Neue Filterbedingung öffnen, nachdem Sie auf Hinzufügen. Im Fenster Neue Filterbedingung werden die folgenden vier Filterbedingungstypen angezeigt, die Active Directory-Attributen zugeordnet sind:

  • Active Directory-Attributübereinstimmung
  • Active Directory-Gruppenabgleich
  • Active Directory-Pfadübereinstimmung
  • Active Directory-Standortübereinstimmung

Für Active Directory-Attributabgleich ist das dynamische Token [ADAttribute:attrName]. Für Active Directory-Gruppenabgleich ist kein dynamisches Token verfügbar, da dieser Bedingungstyp zum Überprüfen einer Gruppenmitgliedschaft verwendet wird. Für Active Directory Path Match lautet das dynamische Token für den vollständigen LDAP-Pfad ##UserLDAPPath##. Für Active Directory Site Match 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] Ertrag Administrator  
[Druckerattribut:Druckername\ attrName] Gibt das angegebene Attribut des angegebenen Domänendruckers zurück [PrinterAttribute:printer1|name] gibt printer1 zurück
[UserParentOU: Ebene] Gibt die angegebene Ebene der übergeordneten Organisationseinheit des aktuellen Benutzers zurück [BenutzerElternteil:1] in CN=Jill Chou,OU=Benutzerkonten,OU=APAC,DC=Citrit,DC=net Ertrag APAC (APAC)  

Register

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

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

XML-Dateien

Um mit einer XML-Datei zu arbeiten, ersetzt WEM die [GetXmlValue:<XML path>|<tag name>] value mit dem spezifischen Tag-Wert in der XML-Datei. Der XML-Pfad kann ein tatsächlicher Pfad oder eine Umgebungsvariable sein, die in einen Pfad aufgelöst wird. Sie müssen die Umgebungsvariable mit % einschließen. Sie können z. B. den folgenden Wert angeben:

  • [GetXmlValue:C:\citrix\test.xml|Zusammenfassung] oder
  • [GetXmlValue:%xmlpath%|Zusammenfassung]

INI-Dateien

Um mit einer .ini Datei zu arbeiten, ersetzt WEM die Datei [GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] mit dem Schlüsselwert. Der INI-Pfad kann ein tatsächlicher Pfad oder eine Umgebungsvariable sein, die in einen Pfad aufgelöst wird. Sie müssen die Umgebungsvariable mit % einschließen. Sie können z. B. 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ützbarkeitsmatrix für Filterbedingungen

In der folgenden Tabelle sind alle Bedingungstypen aufgeführt, deren getesteter Wert oder übereinstimmendes Ergebnis dynamische Token unterstützt.

Typ der Bedingung Geprüfter Wert Passendes Ergebnis
ComputerName Match - Ja
ClientName Match - Ja
Übereinstimmung mit Umgebungsvariablen Nein Ja
Übereinstimmung mit dem Registrierungswert Ja Ja
Übereinstimmung des WMI-Abfrageergebnisses - Ja
Übereinstimmung mit dem Namen der XenApp-Farm - Ja
Übereinstimmung mit dem XenApp-Zonennamen - Ja
Übereinstimmung mit dem Namen der XenDesktop-Farm - Ja
Übereinstimmung mit dem Namen der XenDesktop-Desktopgruppe - Ja
Active Directory-Attributübereinstimmung Ja Ja
Name oder Wert ist in der Liste Ja Ja
Keine ComputerName-Übereinstimmung - Ja
Keine Übereinstimmung mit ClientName - Ja
Keine Übereinstimmung mit Umgebungsvariablen Nein Ja
Keine Übereinstimmung mit dem Registrierungswert Ja Ja
Keine WMI-Abfrageergebnis übereinstimmen - Ja
Keine Übereinstimmung mit dem Namen der XenApp-Farm - Ja
Keine Übereinstimmung mit dem XenApp-Zonennamen - Ja
Keine Übereinstimmung mit dem Namen der XenDesktop-Farm - Ja
Keine Übereinstimmung mit dem Namen der XenDesktop-Desktopgruppe - Ja
Keine Übereinstimmung mit Active Directory-Attribute Ja Ja
Name oder Wert ist nicht in Liste Ja Ja
Dynamische Werteübereinstimmung Ja Ja
Keine dynamische Werteübereinstimmung Ja Ja
Übereinstimmung mit der Dateiversion Ja Ja
Keine Übereinstimmung mit der Dateiversion Ja Ja
Name der veröffentlichten Ressource - Ja
Name ist in der Liste Ja Ja
Name ist nicht in der Liste Ja Ja
Datei/Ordner existiert - Ja
Datei/Ordner existiert nicht - Ja