Product Documentation

SDK

Nov 11, 2015

XenApp y XenDesktop ofrecen un SDK basado en una serie de complementos de Microsoft Windows PowerShell 3.0, que le permite realizar las mismas tareas que lleva a cabo en la consola de Citrix Studio, junto con tareas que no pueden realizarse únicamente con Studio.

A partir de la versión 7.5, XenApp y XenDesktop comparten una arquitectura y una administración unificadas: FlexCast Management Architecture. Esto significa que XenApp proporciona muchas de las características que antes estaban disponibles únicamente en XenDesktop; por lo tanto, los elementos del SDK relacionados con características comunes son aplicables igualmente para XenApp y para XenDesktop, aunque los comandos hagan referencia solo a XenDesktop.

Novedades en el SDK de XenApp y XenDesktop 7.5

El SDK se ha mejorado en esta versión de este modo:
  • Los cmdlets del PowerShell SDK se han ampliado para permitir lo siguiente:
    • Los nuevos tipos de hipervisor respaldados, incluidos AWS y CloudPlatform
    • Respaldo para máquinas der Wake-on-LAN con un nuevo tipo de hipervisor de WakeOnLAN
  • La ampliación del SDK permite configurar propiedades específicas de implementaciones en nube, tales como la selección de la región de conexión y el servicio de volúmenes, y controlar factores tales como la configuración de firewalls de nube para permitir la salida de red desde nubes privadas virtuales.
  • Cuando se asocian para el respaldo de Wake-on-LAN (WOL), los catálogos de acceso con Remote PC ahora pueden asociarse con una instancia de conexión de hipervisor WOL, y cada máquina puede tener capacidades de administración de energía específicas propias.

Diferencias principales entre el SDK de XenDesktop 5 y el de XenDesktop 7

  • Nuevo SDK de alto nivel. XenDesktop 7 ofrece un nuevo SDK de alto nivel que le permite crear scripts y automatizar la creación y el mantenimiento del sitio de forma rápida y sencilla. El SDK de alto nivel le aísla de gran parte de la complejidad de los SDK de bajo nivel hasta el punto de poder crear un nuevo sitio simplemente mediante dos cmdlets.
  • Nuevos SDK de bajo nivel. Hay SDK individuales de bajo nivel para los nuevos servicios de XenDesktop 7, incluido un SDK dedicado y mejorado para Delegated Administration Service (DAS), que formaba parte del SDK del broker de XenDesktop 5. También hay más SDK para nuevas funciones, incluidos Monitor Service, Environment Test y Configuration Logging.
  • Grupos de entrega y catálogos de máquinas con sistema operativo de servidor Windows. No puede usar el SDK de XenDesktop 7 para entregar aplicaciones y escritorios rentables alojados en sistemas operativos de servidor.
  • Aplicaciones con sistema operativo de escritorio. Las aplicaciones con sistema operativo de escritorio han cambiado significativamente a nivel de SDK. Si dispone de scripts existentes para aplicaciones en ejecución en sistemas operativos de escritorio, tendrá que actualizarlos para XenDesktop 7 porque hay poca compatibilidad con versiones anteriores.
  • Aplicar configuración a las máquinas de los grupos de entrega. En XenDesktop 7, mediante las secciones de configuración, puede aplicar configuraciones en las máquinas de un grupo de entrega específico en lugar de hacerlo a todas las máquinas de un sitio. Esto le permite configurar, para un determinado grupo de entrega, los parámetros que se aplican a ese grupo. Hay una serie de secciones de configuración predefinidas que tienen diferentes tipos de configuración, como la configuración para las direcciones de StoreFront que usar con Receiver o las ubicaciones de los servidores de publicación App-V. Puede utilizar un conjunto de parámetros de una sección para que solo afecte a un determinado grupo de entrega y otro conjunto de parámetros de la misma sección para que afecte a otro grupo de entrega. Puede usar nombres adecuados para una implementación en concreto; por ejemplo, "Directiva del departamento de Ventas".
  • Tipos de catálogos reemplazados. En XenDesktop 7, los tipos de catálogos se han reemplazado por catálogos con propiedades individuales. Sin embargo, para la compatibilidad con versiones anteriores, puede usar scripts existentes que emplean tipos de catálogos, tales como una única imagen (agrupados) y "thin clone" (dedicados), etc., pero internamente se convierten en conjuntos de propiedades.
    Precaución: La compatibilidad con versiones anteriores de tipos de catálogos de XenDesktop 5 se ha mantenido siempre que ha sido posible y viable. Sin embargo, al escribir nuevos scripts, no use tipos de catálogos; en su lugar, especifique catálogos con propiedades individuales.
  • Objeto Desktop reemplazado. En XenDesktop 5, el objeto Desktop es uno de los tipos principales de objeto de SDK usado en scripts de SDK de broker. El objeto Desktop describe la máquina y la sesión en la máquina. En XenDesktop 7, este objeto se reemplaza por el objeto Session y el objeto Machine, los cuales ahora realizan el trabajo del objeto Desktop. Sin embargo, para la compatibilidad con versiones anteriores, aún puede usar scripts existentes que usen el objeto Desktop.
    Precaución: La compatibilidad de versiones anteriores con XenDesktop 5 se ha mantenido siempre que ha sido posible y viable. Sin embargo, al escribir nuevos scripts, no use el objeto Desktop; en su lugar, especifique los objetos Session y Machine.

Diferencias en las reglas de directivas

Existen diferencias entre el SDK y la consola de Studio en cuanto a las reglas de directivas. Las reglas de directivas de concesión y asignación son entidades independientes en el SDK; en la consola, estas entidades no son visibles, ya que están perfectamente fusionadas con el grupo de entrega. Además, las reglas de directivas de acceso incluyen menos restricciones en SDK.

Uso de SDK

El SDK se compone de una serie de complementos de PowerShell que se instalan automáticamente mediante el asistente de instalación al instalar el Controller o los componentes de Studio.

Para acceder a los cmdlets y ejecutarlos:

  1. Inicie un shell en PowerShell 3.0.

    Para iniciar un shell desde la consola, haga clic en Studio, seleccione la ficha PowerShell y haga clic en Iniciar PowerShell.

    Debe ejecutar el shell o el script mediante una identidad que posea derechos de administración de Citrix. Si bien los miembros del grupo de administradores locales del Controller disponen automáticamente de privilegios administrativos totales para permitir la instalación de XenDesktop, Citrix recomienda crear administradores Citrix con los derechos adecuados para un funcionamiento normal, en lugar de usar la cuenta de administradores locales. Si está en Windows Server 2008, debe ejecutar el shell o el script como administrador Citrix, no como miembro del grupo de administradores locales.

  2. Para utilizar los cmdlets del SDK en los scripts, configure la directiva de ejecución en PowerShell.

    Para obtener más información acerca de la directiva de ejecución de PowerShell, consulte la documentación de Microsoft.

  3. Agregue los complementos que necesite en el entorno de PowerShell con el comando Add -PSSnapin en la consola de Windows PowerShell. V1 y V2 indican la versión del complemento (los complementos de XenDesktop 5 son la versión 1; los de XenDesktop 7 son la versión 2). Por ejemplo, escriba:
    Add-PSSnapin Citrix.ADIdentity.Admin.V2

    Para importar todos los cmdlets, escriba:

    Add-PSSnapin Citrix.*.Admin.V*

    Después de realizar la importación, tendrá acceso a los cmdlets y a la ayuda asociada.

Para obtener un ejemplo de uso típico, consulte Introducción a SDK.

Sugerencia: Para obtener una lista completa de todo el texto de ayuda de los cmdlets, consulte Ayuda de cmdlet de PowerShell.

Uso de Group Policy SDK

Citrix Group Policy SDK permite visualizar y configurar los filtros y las configuraciones de directivas de grupo. Utiliza un proveedor de PowerShell para crear una unidad virtual que corresponda a la máquina, configuraciones de usuario y filtros. El proveedor aparece como una extensión de New-PSDrive. Para utilizar Group Policy SDK, es necesario tener instalado Studio o el SDK de XenApp y XenDesktop.

Formas de agregar Group Policy SDK

  1. Para agregar Group Policy SDK, escriba:
    Add-PSSnapin citrix.common.grouppolicy
  2. Para acceder a la ayuda, escriba:
    help New-PSDrive -path localgpo:/

Uso de Group Policy SDK

  1. Para crear una unidad virtual y cargarla con configuraciones, escriba:
    New-PSDrive <Standard Parameters> [-PSProvider] CitrixGroupPolicy -Controller <string>

    New-PSDrive <Standard Parameters> [-PSProvider] CitrixGroupPolicy -Controller <string>

    donde -Controller es el nombre de dominio completo (FQDN) de un Controller del sitio al que desea conectarse y desde el cual desea cargar las configuraciones.