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-CsServiceThe 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 -ApplicationServerExample 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 IdentityExample 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