Product Documentation

Kits de développement (SDK) et API

Jun 20, 2017

Plusieurs kits de développement et API sont disponibles avec cette version. Pour de plus amples informations, consultez la section SDK. Cet article contient des liens vers les guides pour :

Le kit de développement de stratégie de groupe Citrix vous permet d'afficher et de configurer les paramètres et les filtres de stratégie de groupe. Il utilise un fournisseur PowerShell pour créer un lecteur virtuel qui correspond aux paramètres et filtres de la machine et de l'utilisateur. Le fournisseur apparaît sous forme d'extension de New-PSDrive. Pour utiliser le kit de développement de stratégie de groupe, soit Studio soit le kit de développement XenDesktop doit être installé. Consultez la section Kit de développement de stratégie de groupe pour de plus amples informations.

SDK Delivery Controller

À partir de la version 7.5.x, XenApp et XenDesktop partagent une architecture et une gestion unifiée : FlexCast Management Architecture. Cela signifie que XenApp offre de nombreuses fonctionnalités précédemment uniquement disponibles dans XenDesktop ; des éléments du Kit de développement logiciel (SDK) qui sont associés à des fonctionnalités communes qui s'appliquent également à XenApp et XenDesktop, même si les commandes font référence uniquement à XenDesktop.

Différences entre le kit de développement XenDesktop 5 et XenDesktop 7

Si vous avez de l'expérience avec le kit de développement XenDesktop 5, la liste suivante résume les différences des versions 7.x du kit de développement XenApp et XenDesktop.

  • Nouveau SDK de haut niveau : XenDesktop 7 fournit un nouveau kit de développement de haut niveau qui vous permet de créer un script et d'automatiser la création de sites et d'effectuer une maintenance rapidement et facilement. Le kit de développement de haut niveau vous isole de la complexité des kits de développement de bas niveau, vous pouvez ainsi créer un nouveau site simplement en exécutant deux applets de commande.
  • Nouveau SDK de bas niveau : les kits de développement de bas niveau individuels sont fournis pour les nouveaux services XenDesktop 7, y compris un SDK dédié et amélioré pour le service d'administration déléguée (DAS), qui faisait précédemment partie du SDK Broker dans XenDesktop 5. Il existe également des kits de développement pour les nouvelles fonctionnalités, y compris le Monitor Service, Environnement de test et Journalisation de la configuration.
  • Catalogues de machine avec OS de serveur Windows et groupes de mise à disposition : vous pouvez utiliser le kit de développement XenDesktop 7 pour mettre à disposition des applications et bureaux hébergés rentables sur des systèmes d'exploitation serveur.
  • Applications de machines avec OS de bureau : les applications de machines avec OS de bureau ont beaucoup changé au niveau du SDK. Si vous disposez de scripts existants pour les applications en cours d'exécution sur des OS de bureau, vous devez mettre à jour ces scripts pour XenDesktop 7 comme il existe peu de compatibilité descendante.
  • Appliquer les paramètres aux machines des groupes de mise à disposition : dans XenDesktop 7, à l'aide des emplacements de configuration, vous pouvez appliquer des paramètres à des machines dans un groupe de mise à disposition spécifique, plutôt qu'à toutes les machines d'un site. Cela vous permet de configurer, pour un groupe de mise à disposition donné, les paramètres qui s'appliquent à ce groupe. Un certain nombre d'emplacements de configuration prédéfinis sont fournis qui contiennent différents types de paramètres, tels que des paramètres pour les adresses StoreFront à utiliser avec les emplacements de serveur de publication Receiver ou App-V. Vous pouvez utiliser un ensemble de paramètres à partir d'un emplacement qui n'affectera qu'un groupe de mise à disposition particulier, et une autre collection de paramètres au même emplacement qui affectera un autre groupe de mise à disposition. Vous pouvez utiliser des noms approprié à votre déploiement particulier ; par exemple, « stratégie Service des ventes. »
  • Types de catalogue remplacés : dans XenDesktop 7, les types de catalogues ont été remplacés par des catalogues avec des propriétés individuelles. Toutefois, pour des raisons de compatibilité, vous pouvez toujours utiliser les scripts existants qui emploient les types de catalogue, tel qu'une image unique (groupée) et clone léger (dédié), etc, mais en interne ceux-ci sont convertis en ensembles de propriétés.Attention : la rétrocompatibilité avec les types de catalogues XenDesktop 5 a été maintenue lorsque cela est possible et réalisable. Toutefois, lors de l'écriture de scripts, n'utilisez pas de types de catalogues ; au lieu de cela, spécifiez les catalogues avec des propriétés individuelles.
  • Objet Bureau remplacé : dans XenDesktop 5, l'objet Bureau est l’un des types principaux d'objets du kit de développement logiciel (SDK) utilisé dans les scripts de SDK de broker. L'objet Bureau décrit la machine et la session sur la machine. Dans XenDesktop 7, cet objet est remplacé par l'objet Session et l’objet Machine, qui ont été développés pour effectuer le travail de l'objet Bureau. Toutefois, pour des raisons de rétrocompatibilité, vous pouvez toujours utiliser des scripts existants qui utilisent l'objet Bureau.Attention : la rétrocompatibilité avec XenDesktop 5 a été maintenue lorsque cela est possible et réalisable. Toutefois, lors de l'écriture de nouveaux scripts, n'utilisez pas l'objet Bureau ; au lieu de cela, spécifiez les objets Session et Machine.

Différences dans les règles de stratégie

Le kit de développement XenDesktop et la console Studio présentent des différences en termes de règles de stratégie. Les règles de stratégie d'attribution et d'affectation sont des entités indépendantes dans le kit de développement ; dans la console, ces entités ne sont pas visibles car elles sont fusionnées de manière transparente avec le groupe de mise à disposition. De plus, les règles de stratégie d'accès sont moins restrictives dans le kit de développement.

Utiliser le SDK Delivery Controller

Le kit de développement logiciel comprend un certain nombre de composants logiciels enfichables PowerShell installés automatiquement par l'assistant d'installation lorsque vous installez les composants Delivery Controller ou Studio.

Autorisations : vous devez exécuter le shell ou le script avec une identité disposant de droits d'administration Citrix. Bien que les membres du groupe d'administrateurs locaux du Controller disposent automatiquement de privilèges d'administration complets pour permettre l'installation de XenApp ou XenDesktop, Citrix vous recommande, pour un fonctionnement normal, de créer des administrateurs Citrix avec les droits appropriés, plutôt que d'utiliser le compte des administrateurs locaux. Si vous exécutez Windows Server 2008 R2, vous devez exécuter le shell ou le script en tant qu'administrateur Citrix, et non en tant que membre du groupe des administrateurs locaux.

Pour accéder aux applets de commande et les exécuter :

  1. Démarrez un shell dans PowerShell 3.0 : ouvrez Studio, sélectionnez l'onglet PowerShell et cliquez sur Lancer PowerShell.
  2. Pour utiliser les applets de commande du kit de développement dans des scripts, définissez la stratégie d'exécution dans PowerShell. Pour plus d'informations sur la stratégie d'exécution PowerShell, veuillez consulter votre documentation Microsoft.
  3. Ajoutez les composants enfichables dont vous avez besoin à l'environnement PowerShell en utilisant l'applet de commande Add -PSSnapin dans la console Windows PowerShell. 

V1 et V2 indiquer la version du composant logiciel enfichable (les composants logiciels enfichables XenDesktop 5 sont à la version 1 ; les composants logiciels enfichables XenDesktop 7 sont à la version 2. Par exemple, pour installer les composants logiciels enfichables XenDesktop 7, tapez Add-PSSnapin Citrix.ADIdentity.Admin.V2). Pour importer tous les applets de commande, tapez : Add-PSSnapin Citrix.*.Admin.V*

Une fois que les composants logiciels enfichables ont été ajoutés, vous pouvez accéder aux applets de commande et à l'aide associée.

REMARQUE : pour consulter l'aide de l'applet de commande PowerShell XenApp et XenDesktop :

  1. À partir de la console PowerShell, ajoutez les composants logiciels enfichables Citrix : Add – PSSnapin Citrix.*.Admin.V*.
  2. Suivez les instructions fournies dans PowerShell (ISE).

Kit de développement de stratégie de groupe

Pour utiliser le kit de développement de stratégie de groupe, soit Studio soit le kit de développement XenDesktop doit être installé.

Pour ajouter le kit de développement de stratégie de groupe, tapez Add-PSSnapin citrix.common.grouppolicy. (Pour obtenir de l'aide, tapez : help New-PSDrive -path localgpo:/)

Pour créer un lecteur virtuel et le charger de paramètres, tapez : New-PSDrive <Paramètres standard> [-PSProvider] CitrixGroupPolicy -Controller <chaîne où la chaîne de Controller correspond au nom de domaine complet d'un Controller du site auquel vous voulez vous connecter et à partir duquel vous voulez charger les paramètres.