Citrix Virtual Apps and Desktops SDK

Get-HypHypervisorPlugin

Gets the available hypervisor types.

Syntax


Get-HypHypervisorPlugin [-ZoneUid <Guid>] [-IncludeUnavailable <Boolean>] [-BearerToken <String>] [-AdminClientIP <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]

<!--NeedCopy-->

Detailed Description

Use this command to retrieve a list of all the available hypervisor types, and their localized names.

Parameters

Name Description Required? Pipeline Input Default Value
ZoneUid ID of the Zone false false  
IncludeUnavailable Specifies whether or not to show all hypervisor plug-ins regardless of availability. false false  
BearerToken Specifies the bearer token assigned to the calling user false false  
AdminClientIP Specifies the client IP of the calling user false false  
TraceParent Specifies the trace parent assigned for internal diagnostic tracing use false false  
TraceState Specifies the trace state assigned for internal diagnostic tracing use false false  
VirtualSiteId Specifies the virtual site the PowerShell snap-in will connect to. false false  
AdminAddress Specifies the address of a XenDesktop controller to which the PowerShell snap-in connects. You can provide this as a host name or an IP address. false false LocalHost. Once a value is provided by any cmdlet, this value becomes the default.

Input Type

System.Guid

Return Values

Citrix.Host.Sdk.Hypervisorplugin

Get-HypHypervisorPlugin returns a list of objects containing the definition of the hypervisor plug-ins.

  • ConnectionType <Citrix.XDInterServiceTypes.ConnectionType> The hypervisor connection type. This can be one of the following: XenServer - XenServer hypervisor SCVMM - Microsoft SCVMM/Hyper-V vCenter - VMWare vSphere/ESX Custom - a third-party hypervisor

  • DisplayName <string> The localized display name (localized using the locale of the Powershell snap-in session)

  • PluginFactoryName <string> The name of the hypervisor plug-in factory used to manage the hypervisor connections.

  • UsesCloudInfrastructure <Boolean> Specifies whether or not the underlying hypervisor plug-in factory employs cloud-hosted infrastructure.

  • CitrixVerified <Boolean> Specifies whether or not the underlying hypervisor plug-in is verified by Citrix.

Notes

To use third-party plug-ins, the plug-in assemblies must be installed into the appropriate location on each controller machine that forms part of the Citrix controller site. Failure to do this can result in unpredictable behavior, especially during service failover conditions. In the case of failure the following errors can result.

  • DatabaseError: An error occurred in the service while attempting a database operation.

  • CommunicationError: An error occurred while communicating with the service.

  • InvalidFilter: A filtering expression was supplied that could not be interpreted for this cmdlet.

  • ExceptionThrown: An unexpected error occurred. To locate more details, see the Windows event logs on the controller being used or examine the XenDesktop logs.

Examples

Example 1


c:\PS> Get-HypHypervisorPlugin | Format-Table -AutoSize

          ConnectionType DisplayName              PluginFactoryName   UsesCloudInfrastructure CitrixVerified

          -------------- -----------              -----------------   ----------------------- --------------

                   SCVMM Microsoft virtualization MicrosoftPSFactory                    False           True

                 VCenter VMware virtualization    VmwareFactory                         False           True

               XenServer Citrix Hypervisor        XenFactory                            False           True

<!--NeedCopy-->

Description

Get the available hypervisor management plug-ins.

Example 2


C:\PS> Get-HypHypervisorPlugin -ZoneUid 2534080e-9226-4af2-a2fc-ec6be14f9552

<!--NeedCopy-->

Description

Get the available hypervisor management plug-ins for the zone with the specified ZoneUid.

Example 3


C:\PS> Get-HypHypervisorPlugin -ZoneUid 2534080e-9226-4af2-a2fc-ec6be14f9552 -IncludeUnavailable $true

<!--NeedCopy-->

Description

Get all Citrix supported hypervisor plug-ins for the specified ZoneUid.

Get-HypHypervisorPlugin