Tokens dinámicos
Puede utilizar tokens dinámicos en cualquier acción de administración del entorno del espacio de trabajo para hacerlos más potentes.
Puede utilizar tokens dinámicos en los siguientes campos:
-
Configuración de directivas de grupo
- Con Acción establecida en Eliminar valor: Valor
- Con Acción establecida en Establecer valor y Tipo establecido en REG_SZ: Valor, Datos
- Con Acción establecida en Establecer valor y Tipo establecido en REG_EXPAND_SZ: Valor, Datos
- Con Acción establecida en Valor establecido y Tipo establecido en REG_MULTI_SZ: Valor, Datos
Nota:
Las configuraciones de la política de grupo son de dos tipos: configuraciones de la máquina y configuraciones de usuario. Para la configuración de la máquina, algunos tokens dinámicos no son compatibles. Consulte Compatibilidad con token dinámico para configuraciones de política de grupo.
Función de token dinámico para la configuración de directivas de grupo
El uso de tokens dinámicos en la configuración de la política de grupo permite una configuración de políticas más adaptable en diferentes entornos, reduce la configuración manual y simplifica la gestión de políticas.
Las configuraciones de la política de grupo son de dos tipos:
- Configuración de la máquina. Esa configuración solo se aplica a las máquinas, independientemente de quién inicie sesión en ellas.
- Configuración de usuario. Esa configuración solo se aplica a los usuarios, independientemente de la máquina en la que inicien sesión.
Todos los tokens dinámicos son compatibles con la configuración de la política de grupo. Los siguientes no son compatibles con la configuración de la máquina.
-
Hashtags
- ##NombreDeUsuarioCompleto##
- ##InicialesDeUsuario##
- ##Nombre del cliente##
- ##Dirección IP del cliente##
- ##Path LDAPP del usuario##
- ##Sistema operativo remoto del cliente##
- Atributo ADA
- [ADAttribute:nombre_del_atractivo]
- [UserParentOU: nivel]
- Registros bajo la HKCU
Aplicaciones
- Con Aplicación de instalación como tipo de aplicación: Línea de comandos, Directorio de trabajoy Parámetros
- Con Archivo/Carpeta como tipo de aplicación: Destino
- Con URL como tipo de aplicación: URL de acceso directo
- Archivo de icono
Impresoras
- Ruta de destino
Unidades de red
- Ruta de destino y Nombre para mostrar
Unidades virtuales
- Ruta de destino
Registros
- Ruta de destino, Nombre de destinoy Valor de destino
Nota:
El campo de valor objetivo ** no admite la expansión de variables de entorno. Si utiliza variables de entorno, no funcionan como se espera.
Variables de entorno
- Valor variable
Puertos
- Objetivo del puerto
Archivos ini
- Ruta de destino, Sección de destino, Nombre del valor de destinoy Valor de destino
Nota:
Los campos Sección de destino, Nombre del valor de destinoy Valor de destino no admiten la expansión de variables de entorno. Si utiliza variables de entorno, no funcionan como se espera.
Tareas externas
- Ruta y Argumentos
Operaciones del sistema de archivos
- Ruta de origen y Ruta de destino
Ciertas condiciones de filtrado
- Ejemplo: Con Coincidencia de atributo de Active Directory* como tipo de condición: **Atributo de Active Directory probado y resultado coincidente**
Nota:
Para obtener una lista completa de los campos admitidos para las condiciones de filtro, consulte Matriz de compatibilidad para condiciones de filtro.
Operaciones con cadenas
A veces es necesario manipular cadenas dentro de un script para mapear unidades o iniciar aplicaciones. El agente de administración del entorno del espacio de trabajo acepta las siguientes operaciones de cadena:
| Modal | Descripción | Ejemplo |
|---|---|---|
| #Izquierda(cadena,longitud)# | Devuelve el número especificado de caracteres a la izquierda. |
#Izquierda(abcdef,2)# devuelve ab
|
| #Derecha(cadena,longitud)# | Devuelve el número especificado de caracteres a la derecha. |
#Derecha(abcdef,2)# devuelve ef
|
| #Truncar(cadena,longitud)# | Si la longitud de la cadena es menor o igual a la longitud especificada, devuelve la cadena completa. Si la longitud de la cadena es mayor que la longitud especificada, devuelve el número especificado de caracteres a la izquierda. |
#Truncar(abcdef,3)# devuelve abc
|
| &Recortar(cadena)& | Elimina todos los espacios en blanco iniciales y finales de la cadena. |
&Recortar( abc )& devuelve abc
|
| &Eliminar espacios(cadena)& | Elimina todos los espacios en blanco de la cadena. |
&Eliminar espacios (abc)& devuelve abc
|
| &Expandir(cadena)& | Si la cadena contiene una variable de entorno encerrada entre \%, expande la variable. |
&Expandir(%userprofile%\destop)& devuelve C:\Users\Jill\desktop
|
| $Split(cadena, divisor], índice)$ | Divide la cadena en subcadenas según el divisor que está entre [] y devuelve la subcadena indexada. |
$Split(abc-def-hij,[-],2)$ devuelve hij
|
| #Mid(cadena,índice inicial)# | Comienza en el índice especificado en la cadena y devuelve todos los caracteres posteriores. |
#Mid(abcdef,2)# devuelve cdef
|
| !Mid(cadena,índice inicial,longitud)! | Comienza en el índice especificado en la cadena y devuelve la cantidad especificada de caracteres. |
!Mid(abcdef,1,2)! devuelve antes de
|
| !Substring(cadena,índice inicial,longitud)! | Comienza en el índice especificado en la cadena y devuelve la cantidad especificada de caracteres. |
!Subcadena(abcdef,1,2)! devuelve antes de
|
| #Mod(cadena,longitud)# | Divide la cadena por la longitud y devuelve el resto. La cadena debe poder convertirse en un entero. |
#Mod(7,3)# devuelve 1
|
Nota:
- Las operaciones de cadena también se admiten con hashtags y atributos de Active Directory. Por ejemplo:
#Left([ADAttribute:NAME],2)#donde el atributo de nombre del usuario del dominio actual esAdministradordevuelveAnuncioy$Split(##ClientIPAddress##,[\.],2)$devuelve157.!Mid(cadena,índice inicial,longitud)!y!Substring(string,startindex,length)!Las operaciones siempre se realizan en último lugar.
Hashtags
Los hashtags son una característica de reemplazo ampliamente utilizada en el procesamiento de elementos de gestión del entorno del espacio de trabajo. El siguiente ejemplo ilustra cómo utilizar hashtags:
Para escribir en un archivo .ini , puede usar %UserName% en la ruta del archivo .ini y Workspace Environment Management lo procesa y expande el directorio final. Sin embargo, evaluar el valor que Workspace Environment Management escribe en el .ini es más complicado: es posible que desees escribir %UserName% literalmente, o escribir el valor expandido.
Para aumentar la flexibilidad, ##UserName## existe como un hash-tag, de modo que al usar %UserName% para un valor lo escribe literalmente y ##UserName## escribe el valor expandido.
Vea la siguiente tabla para ver ejemplos:
| Modal | Descripción | Ejemplo |
|---|---|---|
| ##Nombre de usuario## | Devuelve la variable de entorno expandida “%username%” | Jill |
| ##Perfil de usuario## | Devuelve la variable de entorno expandida “%userprofile%” | C:\Usuarios\Jill |
| ##NombreDeUsuarioCompleto## | Devuelve el nombre completo del usuario en Active Directory | Jill Chou |
| ##InicialesDeUsuario## | Devuelve las iniciales del nombre de usuario en Active Directory | J. C. |
| ##Datos de la aplicación del usuario## | Devuelve la ruta real de la carpeta especial - RoamingAppData | C:\Usuarios\Jill\AppData\Ren modo de almacenamiento en caché |
| ##UsuarioPersonal## | Devuelve la ruta real de la carpeta especial - Documentos | C:\Usuarios\Jill\Documentos |
| ##Documentos de usuario## | Devuelve la ruta real de la carpeta especial - Documentos | C:\Usuarios\Jill\Documentos |
| ##Escritorio de usuario## | Devuelve la ruta real de la carpeta especial - Escritorio | C:\Usuarios\Jill\Escritorio |
| ##Favoritos del usuario## | Devuelve la ruta actual de la carpeta especial: Favoritos | C:\Usuarios\Jill\Favoritos |
| ##Plantillas de usuario## | Devuelve la ruta real de la carpeta especial - Plantillas | C:\Usuarios\Jill\AppData\Roaming\Microsoft\Windows\Tplantillas |
| ##MenúInicioUsuario## | Devuelve la ruta actual de la carpeta especial - StartMenu | C:\Usuarios\Jill\AppData\Roaming\Microsoft\Windows\Menú Inicio |
| ##ProgramasMenúInicioUsuario## | Devuelve la ruta real de la carpeta especial - Programas | C:\Usuarios\Jill\AppData\Roaming\Microsoft\Windows\Menú Inicio\Programas |
| ##Datos de aplicación local del usuario## | Devuelve la ruta real de la carpeta especial - LocalAppData | C:\Users\Jill\AppData\Local |
| ##Música de usuario## | Devuelve la ruta actual de la carpeta especial: Música | C:\Usuarios\Jill\Música |
| ##Imágenes de usuario## | Devuelve la ruta actual de la carpeta especial - Imágenes | C:\Usuarios\Jill\Imágenes |
| ##Videos de usuario## | Devuelve la ruta actual de la carpeta especial - Videos | C:\Usuarios\Jill\Videos |
| ##Descargas de usuario## | Devuelve la ruta actual de la carpeta especial - Descargas | C:\Usuarios\Jill\Descargas |
| ##Enlaces de usuario## | Devuelve la ruta actual de la carpeta especial - Enlaces | C:\Usuarios\Jill\Enlaces |
| ##Contactos de usuario## | Devuelve la ruta real de la carpeta especial: Contactos | C:\Usuarios\Jill\Contactos |
| ##Búsquedas de usuarios## | Devuelve la ruta real de la carpeta especial - SavedSearches | C:\Usuarios\Jill\Búsquedas |
| ##programas comunes## | Devuelve la ruta real de la carpeta especial - CommonPrograms | C:\ProgramData\Microsoft\Windows\Menú Inicio\Programas |
| ##NombreDeComputadora## | Devuelve el nombre de la máquina. | WIN10EN-LR3B66L |
| ##Nombre del cliente## | Devuelve el nombre de la máquina cliente | W2K16ST-5IS28JP |
| ##Dirección IP del cliente## | Devuelve la dirección IP de la máquina cliente | 10.150.153.138 |
| ##Dirección IP## | Devuelve la dirección IP de la máquina. | 10.150.153.213 |
| ##Sitio ANUNCIOSO## | Devuelve el sitio de Active Directory del que la máquina es miembro | NKG |
| ##ValorRegPredeterminado## | - | Siempre cadena.Vacío |
| ##Path LDAPP del usuario## | Devuelve el nombre distintivo del usuario actual | CN=Jill Chou,OU=Cuentas de usuario,OU=APAC,DC=citrite,DC=net |
| ##Carpeta VUEMAgent## | Devuelve la carpeta del agente | C:\Archivos de programa (x86)\Citrix\Workspace Environment Management Agent |
| ##ID de sesión RDS## | Devuelve el ID de la sesión del escritorio remoto | 2 |
| ##NombreSesiónRDSS## | Devuelve el nombre de la sesión de escritorio remoto | RDP-Tcp#72 |
| ##Sistema operativo remoto del cliente## | Devuelve el sistema operativo de la máquina utilizada para conectarse al escritorio virtual | Ventanas |
| ##Información del sistema operativo del cliente## | Devuelve la información del sistema operativo de la máquina. | Windows 10 Enterprise de 64 bits |
El hashtag ##UserScreenCaptureComment## se implementa para su uso en partes específicas del producto. Esta etiqueta se puede incluir en la plantilla de correo electrónico en Configuración avanzada > Personalización del agente de UI > Opciones de la mesa de ayuda. Cuando se incluye, a los usuarios se les presenta un campo de comentarios ubicado debajo de la captura de pantalla en la utilidad de captura de pantalla del agente. El comentario se incluye en el correo electrónico de soporte en la ubicación en la que colocó la etiqueta en la plantilla de correo electrónico.
Atributos de Active Directory
Para trabajar con atributos de Active Directory, WEM reemplaza el valor [ADAttribute:attrName] con el atributo de Active Directory relacionado. [ADAttribute:attrName] es el token dinámico para cualquier atributo de Active Directory. Hay un filtro relacionado que verifica el valor de los atributos especificados.
Para las estructuras de unidades organizativas (OU) de usuario, WEM reemplaza el valor [UserParentOU:level] con el nombre de la OU de Active Directory relacionada. La ruta de Active Directory es la ruta de usuario completa (LDAP) en Active Directory y [UserParentOU:level] es un subconjunto de ella.
Por ejemplo, supongamos que desea crear una unidad de red para una OU a la que pertenecen los usuarios. Puede utilizar el token dinámico [UserParentOU:level] en la ruta de la unidad de red para resolver la OU de los usuarios de forma dinámica. Hay dos formas de utilizar el token dinámico:
- Utilice el token dinámico [UserParentOU:level] directamente en la ruta de la unidad de red. Por ejemplo, puede utilizar la siguiente ruta:
\\Server\Share\[UserParentOU:0]\. - Establezca una variable de entorno llamada OU y luego establezca su valor en [UserParentOU:0]. Luego puedes asignar la unidad como
\\Server\Share\%OU%\.
Nota:
- Puedes sustituir el dígito “0” por el número que corresponda al nivel que deseas alcanzar en la estructura de la OU.
- Puedes añadir variables a la ruta. Para ello, asegúrese de tener una estructura de carpetas exacta que coincida con el diseño de su OU.
También puede utilizar atributos de Active Directory para fines de filtrado. En la pestaña Administración > Filtros > Condiciones > Lista de condiciones de filtro , puede abrir la ventana Nueva condición de filtro después de hacer clic en Agregar. En la ventana Nueva condición de filtro, puede ver los siguientes cuatro tipos de condiciones de filtro asociados con los atributos de Active Directory:
- Coincidencia de atributos de Active Directory
- Coincidencia de grupo de Active Directory
- Coincidencia de ruta de Active Directory
- Coincidencia de sitio de Active Directory
Para la coincidencia de atributos de Active Directory, el token dinámico es [ADAttribute:attrName]. No hay ningún token dinámico disponible para Active Directory Group Match porque ese tipo de condición se utiliza para verificar la membresía de un grupo. Para Active Directory Path Match, el token dinámico para la ruta LDAP completa es ##UserLDAPPath##. Para Active Directory Site Match, el token dinámico es ##ADSite##.
Vea la siguiente tabla para ver ejemplos:
| Modal | Descripción | Ejemplo | |
|---|---|---|---|
| [ADAttribute:nombre_del_atractivo] | Devuelve el atributo especificado del usuario del dominio. |
[ADAttribute:name] devuelve Administrador
|
|
| [Atributo de impresora:nombre de impresora\ | [nombre_atributo] | Devuelve el atributo especificado de la impresora de dominio especificada | [PrinterAttribute:printer1|name] devuelve printer1 |
| [UserParentOU: nivel] | Devuelve el nivel especificado de la OU principal del usuario actual |
[UserParentOU:1] en CN=Jill Chou,OU=Cuentas de usuario,OU=APAC,DC=citrite,DC=net devuelve APAC
|
Registros
Para trabajar con un registro, WEM reemplaza el valor [RegistryValue:<Registry path>] con el valor de registro relacionado. Por ejemplo, puede especificar el siguiente valor:
- [Valor de registro:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Host del agente\Ubicación del agente]
Archivos XML
Para trabajar con un archivo XML, WEM reemplaza el valor [GetXmlValue:<XML path>|<tag name>] con el valor de etiqueta específico en el archivo XML. La ruta XML puede ser una ruta real o una variable de entorno que se resuelve en una ruta. Debes encerrar la variable de entorno entre %. Por ejemplo, puede especificar el siguiente valor:
- [GetXmlValue:C:\citrix\test.xml|summary] o
- [GetXmlValue:%xmlpath%|resumen]
Archivos INI
Para trabajar con un archivo .ini, WEM reemplaza [GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] con el valor de la clave. La ruta INI puede ser una ruta real o una variable de entorno que se resuelve en una ruta. Debes encerrar la variable de entorno entre %. Por ejemplo, puede especificar el siguiente valor:
- [GetIniValue:C:\citrix\test.ini|PLD_POOL_LIC_NODE_0_0|LicExpTime] o
- [Obtener valor inicial:%inipath%|PLD_POOL_LIC_NODE_0_0|Tiempo de espera de licencia]
Más información
Matriz de compatibilidad para condiciones de filtrado
En la siguiente tabla se enumeran todos los tipos de condiciones cuyo valor probado o resultado coincidente admite tokens dinámicos.
| Tipo de condición | Valor probado | Resultado coincidente |
|---|---|---|
| Coincidencia de ComputerName | - | Sí |
| Coincidencia de ClientName | - | Sí |
| Coincidencia de variable de entorno | No | Sí |
| Coincidencia de valor del Registro | Sí | Sí |
| Coincidencia de resultados de consulta WMI | - | Sí |
| Coincidencia de nombre de granja de XenApp | - | Sí |
| Coincidencia de nombre de zona de XenApp | - | Sí |
| Coincidencia de nombres de granjas de XenDesktop | - | Sí |
| Coincidencia de nombre de grupo de escritorios de XenDesktop | - | Sí |
| Coincidencia de atributos de Active Directory | Sí | Sí |
| Nombre o valor está en la lista | Sí | Sí |
| No hay coincidencia de ComputerName | - | Sí |
| No hay coincidencia de ClientName | - | Sí |
| Sin coincidencia de variable de entorno | No | Sí |
| Sin coincidencia de valor del Registro | Sí | Sí |
| No hay coincidencia de resultado de consulta WMI | - | Sí |
| No hay coincidencia de nombre de granja XenApp | - | Sí |
| No hay coincidencia de nombre de zona de XenApp | - | Sí |
| No hay coincidencia de nombre de granja de XenDesktop | - | Sí |
| No hay coincidencia de nombre de grupo de escritorios de XenDesktop | - | Sí |
| No hay coincidencia de atributo de Active Directory | Sí | Sí |
| El nombre o el valor no está en la lista | Sí | Sí |
| Coincidencia de valor dinámico | Sí | Sí |
| No hay coincidencia de valor dinámico | Sí | Sí |
| Coincidencia de versión de archivo | Sí | Sí |
| No coincide con la versión del archivo | Sí | Sí |
| Nombre de recurso publicado | - | Sí |
| El nombre está en la lista | Sí | Sí |
| El nombre no está en la lista | Sí | Sí |
| El archivo/carpeta existe | - | Sí |
| El archivo/carpeta no existe | - | Sí |
En este artículo
- Función de token dinámico para la configuración de directivas de grupo
- Aplicaciones
- Impresoras
- Unidades de red
- Unidades virtuales
- Registros
- Variables de entorno
- Puertos
- Archivos ini
- Tareas externas
- Operaciones del sistema de archivos
- Ciertas condiciones de filtrado
- Operaciones con cadenas
- Hashtags
- Atributos de Active Directory
- Registros
- Archivos XML
- Archivos INI
- Más información