SDKs and APIs
Several SDKs and APIs are available with this release. For details, see Developer Documentation. From there, you can access programming information for:
- Delivery Controller
- Monitor Service OData
The Citrix Group Policy SDK allows you to display and configure Group Policy settings and filters. It uses a PowerShell provider to create a virtual drive that corresponds to the machine and user settings and filters. The provider appears as an extension to New-PSDrive. To use the Group Policy SDK, either Studio or the Citrix Virtual Apps and Desktops SDK must be installed. See Group Policy SDK for more information.
Delivery Controller SDK
The SDK comprises several PowerShell snap-ins that are installed automatically when you install a Delivery Controller or Studio.
Permissions: You must run the shell or script using an identity that has Citrix administration rights. Although members of the local administrators group on the Controller automatically have full administrative privileges to allow Citrix Virtual Apps or Citrix Virtual Desktops to be installed, Citrix recommends that for normal operation, you create Citrix administrators with the appropriate rights, rather than use the local administrators account.
To access and run the cmdlets:
- Start a shell in PowerShell: Open Studio, select the PowerShell tab, and then click Launch PowerShell.
- To use SDK cmdlets within scripts, set the execution policy in PowerShell. For more information about PowerShell execution policy, see the Microsoft documentation.
Add the snap-ins you require into the PowerShell environment using the
Add -PSSnapincmdlet in the Windows PowerShell console.
V1 and V2 denote the version of the snap-in. XenDesktop 5 snap-ins are version 1. Citrix Virtual Apps and Desktops, and earlier XenDesktop 7 version snap-ins are version 2. For example, to install Citrix Virtual Apps and Desktops snap-ins, type
Add-PSSnapin Citrix.ADIdentity.Admin.V2. To import all of the cmdlets, type:
After adding the snap-ins, you can access the cmdlets and their associated help.
To see the current Citrix Virtual Apps and Desktops PowerShell cmdlet help:
- From the PowerShell console, add the Citrix snap-ins:
Add –PSSnapin Citrix.*.Admin.V*.
- Follow the instructions in PowerShell Integrated Scripting Environment (ISE).
Group Policy SDK
To use the Group Policy SDK, either Studio or the Citrix Virtual Apps and Desktops SDK must in installed.
To add the Group Policy SDK, type
Add-PSSnapin citrix.common.grouppolicy. (To access help, type:
help New-PSDrive -path localgpo:/)
To create a virtual drive and load it with settings, type
New-PSDrive <Standard Parameters> [-PSProvider] CitrixGroupPolicy -Controller <string> where the Controller string is the fully qualified domain name of a Controller in the Site you want to connect to and load settings from.
Monitor Service OData
The Monitor API allows access to the Monitor Service data using Version 3 or 4 of the OData API. You can create customized monitoring and reporting dashboards based on data queried from the Monitor Service data. OData V.4 is based on the ASP.NET Web API and supports aggregation queries. For more information, see the Monitor Service OData API.