Get-CsService

Returns information about the services and server roles being used in your Skype for Business Server infrastructure. A service is an instance of a role that has been deployed in a Skype for Business Server pool. For example, you might have a pool of computers all running the Monitoring service. This cmdlet was introduced in Lync Server 2010.

Syntax

Get-CsService
   [[-Identity] <XdsGlobalRelativeIdentity>]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-Filter <String>]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-ApplicationDatabase]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-ApplicationServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-ArchivingDatabase]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-ArchivingServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-CentralManagement]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-CentralManagementDatabase]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-ConferencingServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-Director]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-EdgeServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-FileStore]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-ManagementServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-MediationServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-MonitoringServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-MonitoringDatabase]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-ProvisionServer]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-ProvisionDatabase]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-PstnGateway]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-Registrar]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-TrustedApplicationPool]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-UserDatabase]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-UserServer]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-WebServer]
   [<CommonParameters>]
Get-CsService
   [-BackupServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-LegalInterceptServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-PersistentChatComplianceDatabase]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-PersistentChatDatabase]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-PersistentChatServer]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-WacServer]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-VideoGateway]
   [<CommonParameters>]
Get-CsService
   [-PoolFqdn <String>]
   [-VideoInteropServer]
   [<CommonParameters>]

Description

The capabilities found in Skype for Business Server are typically expressed as services or as server roles. For example, you can configure Skype for Business Server to automatically save a transcript of every instant messaging session that takes place in your organization. In order to do this, you must install the Archiving Server server role. Services and server roles can be configured at the same time you install Skype for Business Server itself, or they can be configured after the software is up and running.

The Get-CsService cmdlet enables you to return information about the server roles and services running in your organization. Called without any additional parameters, the Get-CsService cmdlet returns detailed information about all your services and server roles. Alternatively, you can limit the returned data to a specified pool by using the PoolFqdn parameter. In addition, you can use any number of switch parameters to limit the returned data to a specific type of service. A switch parameter is a parameter that does not require a parameter value. For example, this command returns information about all your Archiving Servers:

Get-CsService -ArchivingServer

Note that you can only use one such switch parameter per command. The following command, which tries to return information about both Archiving Servers and Monitoring Servers, will fail:

Get-CsService -ArchivingServer -MonitoringServer

If you need to return information for multiple server roles, you can use the Get-CsService cmdlet to return a complete collection of service data, and then pipe that data to the Where-Object cmdlet:

Get-CsService | Where-Object {$_.Role -eq "ArchivingServer" -or $_.Role -eq "MonitoringServer"}

Examples

-------------------------- Example 1 --------------------------

Get-CsService

The command shown in Example 1 returns information about all the Skype for Business Server services and server roles currently running in your organization.

-------------------------- Example 2 --------------------------

Get-CsService -ApplicationServer

Example 2 returns information only about the Application service. You can return information for other services/server roles simply by using the appropriate parameter. For example, this command returns information about the file store:

-------------------------- Example 3 --------------------------

Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity

Example 3 reports back the Identity for each service located on the pool atl-cs-001.litwareinc.com. To carry out this task, the command first calls the Get-CsService cmdlet and the PoolFqdn parameter to return only those services and server roles found on the pool atl-cs-001.litwareinc.com. This collection is then piped to the Select-Object cmdlet, which reports back the Identity of each item in the collection.

-------------------------- Example 4 --------------------------

Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}

In Example 4, information is returned for all the services/server roles found on the Redmond site. This is done by first calling the Get-CsService cmdlet without any parameters in order to return a collection of all the services and server roles currently in use in the organization. This data is then piped to the Where-Object cmdlet, which picks out only those items where the SiteID property is equal to site:Redmond.

-------------------------- Example 5 --------------------------

Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}

The command shown in Example 5 returns information about all the services that list the Registrar as a dependent service. To do this, the Get-CsService cmdlet is called in order to return a collection of all the services and server roles currently in use. This collection is then piped to the Where-Object cmdlet, which selects each item where the DependentServiceList property includes the string value "Registrar". The Where-Object cmdlet criteria is specified by using the -like operator and the wildcard value "Registrar".

Parameters

-ApplicationDatabase

Returns information about the Application databases used in your organization. Application databases are used by the Application service.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ApplicationServer

Returns information about the Application service. The Application service provides a way to run applications created by using the Microsoft Unified Communications Managed API (UCMA).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ArchivingDatabase

Returns information about the Archiving databases used in your organization. Archiving databases store transcripts of instant messaging sessions.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ArchivingServer

Returns information about the Archiving Servers used in your organization. Archiving Servers enable you to save the transcripts of instant messaging sessions.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-BackupServer

Returns information about the backup servers used in your organization.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-CentralManagement

Returns information about the Central Management service used in your organization. The Central Management service is used to send configuration data to computers running Skype for Business Server services.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-CentralManagementDatabase

Returns information about the Central Management store used in your organization. The Central Management store maintains configuration information for Skype for Business Server.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ConferencingServer

Returns information about the A/V Conferencing service used in your organization. The A/V Conferencing service is used to conduct meetings and conferences.

Type:SwitchParameter
Aliases:ConferenceServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Director

Returns information about the Directors used in your organization. Directors are empowered to handle user requests and user authentication, but do not house user accounts. Directors are typically used to handle requests from external users.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-EdgeServer

Returns information about the Edge Servers used in your organization. Edge Servers provide connectivity between your internal network and the Internet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-FileStore

Returns information about the File Stores used in your organization. The File Store is used to maintain Skype for Business Server files, such as audio files used by the Announcement service.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Filter

Enables you to use wildcards to specify the service (or services) to be returned. You cannot use both the Identity and the Filter parameters in the same command.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Identity

Unique identifier of the specific service or server role to be returned. For example:

-Identity "Registrar:atl-cs-001.litwareinc.com"

Type:XdsGlobalRelativeIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-LegalInterceptServer

Returns information about the legal intercept servers used in your organization. Legal intercept servers provide real-time interception of instant messaging communications on Office 365.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013

-ManagementServer

Returns information about the Central Management Server used in your organization. The Central Management Server is commonly collocated with the Front End Servers and is responsible for accessing information in the Central Management store.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MediationServer

Returns information about the Mediation Servers used in your organization. Mediation Servers help provide a bridge between your Enterprise Voice network and the public switched telephone network (PSTN).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MonitoringDatabase

Returns information about the monitoring databases used in your organization. Monitoring databases store Enterprise Voice phone usage and call quality information.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MonitoringServer

Returns information about the Monitoring Servers used in your organization. Monitoring Servers are used to track Enterprise Voice phone usage and call quality.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-PersistentChatComplianceDatabase

Returns information about the databases used for maintaining Persistent Chat compliance information.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-PersistentChatDatabase

Returns information about the databases used for maintaining Persistent Chat information.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-PersistentChatServer

Returns information about the Persistent Chat servers used in your organization.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-PoolFqdn

Fully qualified domain name (FQDN) of the pool hosting the service or server role. If you use the PoolFqdn parameter without specifying a service-specific parameter, then all the services and server roles found on that pool will be returned.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ProvisionDatabase

Returns information about the provision databases used in your organization. Provision databases maintain information about Lync Server certificates.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010

-ProvisionServer

Returns information about the Provision Server service used in your organization. The Provision Server service is used to manage Lync Server certificates.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010

-PstnGateway

Returns information about the public switched telephone network (PSTN) gateways used in your organization. PSTN gateways translate signals from Enterprise Voice devices to signals that can be understood by PSTN devices, and vice-versa.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Registrar

Returns information about the Registrars used in your organization. Registrars are used to authenticate users and to keep track of a user's current status.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-TrustedApplicationPool

Returns information about the trusted application pools used in your organization. Trusted applications pools host computers that run trusted applications.

Type:SwitchParameter
Aliases:ExternalServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-UserDatabase

Returns information about the User database used in your organization. User databases store data needed by the User Server service.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-UserServer

Returns information about the User Services service used in your organization. The User Services service provides such things as user replication, in-band provisioning, presence publication and notification, and contact card exchange.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-VideoGateway

Returns information about the video gateway service. Video gateways provide a way to connect Skype for Business users to video teleconferencing devices.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-VideoInteropServer

Returns information about the video interoperability service. The video interoperability service provides a way to seamless connect Skype for Business users to third-party video teleconferencing providers.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-WacServer

Returns information about the Office Web Apps servers used with Microsoft Lync Server. Office Web Apps server was previously known as "WacServer".

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WebServer

Returns information about the Web Services service used in your organization. The Web Services service host web-based applications such as the Address Book service.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

None

Outputs

The Get-CsService cmdlet returns different objects based on the parameters used when calling the cmdlet. For example, if you include the MonitoringDatabase parameter, the Get-CsService cmdlet returns instances of the Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase object. To determine the objects returned using other parameters, call the Get-CsService cmdlet using one of those parameters, and then pipe the returned object to the Get-Member cmdlet. For example:

Get-CsService -Registrar | Get-Member