Developer Documentation
Citrix Virtual Apps and Desktops SDK
Current Release 2402 2311 2305 2303 2212 2209 2206 2203 2112 2109 2103 1912
View PDF

Register-ConfigServiceInstance

August 3, 2023
Contributed by: 
C

Allows the registration of a service instance.

Syntax


Register-ConfigServiceInstance -ServiceGroupUid <Guid> -ServiceGroupName <String> -ServiceType <String> -Address <String> -Binding <String> -Version <Int32> -ServiceAccount <String> -InterfaceType <String> [-LoggingId <Guid>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]

Register-ConfigServiceInstance -ServiceGroupUid <Guid> -ServiceGroupName <String> -ServiceType <String> -Address <String> -Binding <String> -Version <Int32> -ServiceAccountSid <String> -InterfaceType <String> [-LoggingId <Guid>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]

Register-ConfigServiceInstance -ServiceInstance <ServiceInstance[]> [-LoggingId <Guid>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]

<!--NeedCopy-->

Detailed Description

Use this cmdlet to register service instance items in the Configuration Service. Service instances can be registered either by retrieving the data directly from other services or by manually entering the details into this command.

If the service group specified by the service instance already exists, the service is added to the service group, otherwise a new service group is created to hold the service instance.

Parameters

Name Description Required? Pipeline Input Default Value
ServiceGroupUid The Service Group Unique Identifier true true (ByPropertyName)  
ServiceGroupName The name of the service group true true (ByPropertyName)  
ServiceType The type of the service group true true (ByPropertyName)  
Address The address that is used to access the service instance. true true (ByPropertyName)  
Binding The binding type that must be used to access the service instance. true true (ByPropertyName)  
Version The version of the service instance. true true (ByPropertyName)  
ServiceAccount The AD computer account name (domain qualified) for the computer on which the service instance is hosted. true true (ByPropertyName)  
InterfaceType The type of interface that the service provides (i.e. SDK, InterService, Peer). true true (ByPropertyName)  
ServiceAccountSid The AD computer account Sid for the computer on which the service instance is hosted. true true (ByPropertyName)  
ServiceInstance The service instances to register. true true (ByValue)  
LoggingId Specifies the logging id of the high-level operation that this cmdlet is part of. false true (ByPropertyName)  
BearerToken Specifies the bearer token assigned to 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 that the PowerShell snap-in connects to. You can be 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

Citrix.Configuration.Sdk.Serviceinstance

An Object With The Following Parameters Can Be Used To Register A Service Instance. Address, Servicegroupuid, Servicegroupname, Servicetype, Binding, Version, Interfacetype.

Return Values

Citrix.Configuration.Sdk.Serviceinstance

This represents a service instance and has the following parameters;

  • ServiceGroupUid <Guid> The unique identifier for the service group to which the service instance belongs.

  • ServiceGroupName <string> The name of the service group to which the service instance belongs.

  • ServiceInstanceUid <Guid> The unique identifier for the service instance.

  • ServiceType <string> The type of the service group.

  • Address <string> The contact address for the service instance.

  • Binding <string> The binding to use for connections to the service instance.

  • Version <int> The version of the service instance.

  • ServiceAccount <string> The AD computer account for the computer that is providing the service instance.

  • ServiceAccountSid <string> The AD computer account SID for the computer that is providing the service instance.

  • InterfaceType <string> The interface type for the service instance.

  • Metadata <Citrix.Configuration.Sdk.Metadata[]> The metadata for the service instance.

Notes

In the case of failure, the following errors can result.

  • ActiveDirectoryAccountResolutionFailed: The account name provided could not be found in Active Directory.

  • ServiceGroupWithSameUidExistsForDifferentServiceGroupNameOrSameUidExistsForDifferentServiceGroupNameOrServiceType: The service group name or service type do not match the service group found with the specified uid.

  • TypeAlreadyExists: A different service group with the same type is registered already in the Configuration Service.

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

  • DatabaseNotConfigured: The operation could not be completed because the database for the service is not configured.

  • DataStoreException: An error occurred in the service while attempting a database operation - communication with the database failed for various reasons.

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

  • ExceptionThrown: An unexpected error occurred.

For more details, see the Windows event logs on the controller being used or examine the XenDesktop logs.

Examples

Example 1 


C:\PS>Get-ConfigServiceInstance | Register-ConfigServiceInstance

<!--NeedCopy-->

Description

Gets the service instances for the Configuration Service and registers them.

Register-ConfigServiceInstance
August 3, 2023
Contributed by: 
C
August 3, 2023
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.