Get-ConfigSite

Last published : Oct 31, 2026
Gets the overall settings of the site.
Related information
about_ConfigConfigurationSnapIn

Syntax

Get-ConfigSite
   [-LicenseServerName <String>]
   [-LicenseServerPort <Int32>]
   [-LicenseServerUri <Uri>]
   [-UseLicenseActivationService <Boolean>]
   [-LicensingModel <String>]
   [-PrimaryZone <Zone>]
   [-ProductCode <String>]
   [-ProductEdition <String>]
   [-ProductVersion <String>]
   [-SiteName <String>]
   [-IgnoreZoneHealth <Boolean>]
   [-LogServerEnabled <Boolean>]
   [-LogServerName <String>]
   [-LogServerPort <Int32>]
   [<CitrixCommonParameters>]
   [<CommonParameters>]

Description

The Get-ConfigSite cmdlet gets the overall settings of the site.
The site is a top-level, logical representation of the XenDesktop site, from the perspective of the configuration services running within the site.
A XenDesktop installation has only a single site instance.

Examples

EXAMPLE 1

Gets the site.
Get-ConfigSite

Parameters

-LicenseServerName

Gets the site where the machine used by the brokering services to obtain licenses for desktop and application session brokering matches the specified value.
The license server machine can be specified by its DNS name ('machine.domain') or its numeric IP address.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: True

-LicenseServerPort

Gets the site where the port number on the license server machine used by the brokering services to contact the Citrix license server matches the specified value.
Type: Int32
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-LicenseServerUri

Gets the site where the Uri of the web server for licensing matches the specified value. The hostname component of this Uri must match the Site's LicenseServerName property.
Type: Uri
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-UseLicenseActivationService

Gets the site matching the specified value for using LicenseActivationService instead of LPE. NOTE: Only available in 2402 CU3 or later.
Type: Boolean
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False
Introduced in: Citrix Virtual Apps and Desktop 7 2402 CU3

-LicensingModel

Gets the site where the license model matches the specified value.
The Get-ConfigLicensingModel returns a list of supported values.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: True

-PrimaryZone

Gets the site where the primary zone matches the specified value.
The primary zone can be specified by Uid, Name or by passing a Zone object.
Type: Zone
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-ProductCode

Gets the site where the product code matches the specified value.
The Get-ConfigProduct cmdlet returns a list of supported values.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: True

-ProductEdition

Gets the site where the license edition matches the specified value.
The Get-ConfigProductEdition returns a list of supported values.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-ProductVersion

Gets the site where the product version matches the specified value.
The Get-ConfigProductVersion returns a list of supported values.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: True

-SiteName

Gets the site where the name matches the specified value.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-IgnoreZoneHealth

Gets the site matching the specified IgnoreZoneHealth configuration value.
This configuration allows treating machines in an unhealthy zone as if the zone is healthy. When enabled, operations like launching sessions and managing power will be attempted on machines in the unhealthy zone, disregarding the actual zone health status.
Type: Boolean
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False
Introduced in: Citrix Virtual Apps and Desktop 7 2402 CU3

-LogServerEnabled

Gets the site matching the specified value for whether use of the Citrix log server for log collection is enabled or disabled.
Type: Boolean
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False
Introduced in: Citrix Virtual Apps and Desktop 7 2402 CU3

-LogServerName

Gets the site where the machine used by the brokering services for centralized log collection matches the specified value. The specified machine must be running a Citrix log server and have suitable licenses.
The log server machine can be specified by its DNS name ('machine.domain') or its numeric IP address.
Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: True
Introduced in: Citrix Virtual Apps and Desktop 7 2402 CU3

-LogServerPort

Gets the site where the port number used by the brokering services to contact the centralized log server matches the specified value.
Type: Int32
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False
Introduced in: Citrix Virtual Apps and Desktop 7 2402 CU3

CitrixCommonParameters

This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -SkipCertificateValidation, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

You can't pipe objects to this cmdlet.

Outputs

Citrix.Configuration.Sdk.Site

Provides information about the site