Get-CsService
上一次修改主题: 2012-03-23
返回有关 Microsoft Lync Server 2010 基础结构中使用的服务和服务器角色的信息。服务是在 Lync Server 2010 池中部署的角色的实例。例如,您可能拥有一个计算机池,其中所有计算机都运行监控服务器服务。
语法
Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]
Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]
Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]
Get-CsService [-Filter <String>] [-PoolFqdn <String>]
详细说明
Lync Server 2010 中的功能通常表示为服务或服务器角色。例如,您可以将 Lync Server 配置为自动保存组织中进行的每个即时消息会话的脚本。为执行此操作,您必须安装“存档服务器”服务器角色。可以在安装 Lync Server 本身的同时配置服务和服务器角色,也可以在安装并运行该软件后配置服务和服务器角色。
通过 Get-CsService cmdlet,可以返回有关组织中运行的服务器角色和服务的信息。调用不带其他任何参数的 Get-CsService 可返回有关所有服务和服务器角色的详细信息。或者,您也可以使用 PoolFqdn 参数将返回的数据限制为指定的池。此外,您还可以使用任意数量的开关参数将返回的数据限制为特定类型的服务。开关参数是不需要参数值的参数。例如,以下命令可返回有关所有存档服务器的信息:
Get-CsService –ArchivingServer
请注意,每个命令只能使用一个此类开关参数。尝试同时返回有关存档服务器和监控服务器的信息的以下命令将失败:
Get-CsService –ArchivingServer –MonitoringServer
如果需要返回多个服务器角色的信息,可以使用 Get-CsService 返回服务数据的完整集合,然后将该数据通过管道传递到 Where-Object cmdlet:
Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsService cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的特定服务或服务器角色的唯一标识符。例如:-Identity "Registrar:atl-cs-001.litwareinc.com"。 |
Filter |
可选 |
字符串 |
使您可以使用通配符来指定要返回的一个或多个服务。不能在同一个命令中同时使用 Identity 参数和 Filter 参数。 |
ApplicationDatabase |
可选 |
开关参数 |
返回有关您组织中使用的应用程序数据库的信息。应用程序数据库由应用程序服务使用。 |
ApplicationServer |
可选 |
开关参数 |
返回有关应用程序服务的信息。应用程序服务提供了一种运行使用 Microsoft 统一通信托管 API (UCMA) 创建的应用程序的方法。 |
ArchivingDatabase |
可选 |
开关参数 |
返回有关您组织中使用的存档数据库的信息。存档数据库可存储即时消息会话的脚本。 |
ArchivingServer |
可选 |
开关参数 |
返回有关您组织中使用的存档服务器的信息。存档服务器使您可以保存即时消息会话的脚本。 |
CentralManagement |
可选 |
开关参数 |
返回有关您组织中使用的中央管理服务的信息。中央管理服务用于向运行 Lync Server 2010 服务的计算机发送配置数据。 |
CentralManagementDatabase |
可选 |
开关参数 |
返回有关您组织中使用的中央管理存储的信息。中央管理存储可保存 Lync Server 的配置信息。 |
ConferencingServer |
可选 |
开关参数 |
返回有关您组织中使用的A/V 会议服务的信息。A/V 会议服务用于进行会议。 |
Director |
可选 |
开关参数 |
返回有关您组织中使用的控制器的信息。增强控制器以处理用户请求和用户身份验证,但不能托管用户帐户。控制器通常用于处理外部用户的请求。 |
EdgeServer |
可选 |
开关参数 |
返回有关您组织中使用的边缘服务器的信息。边缘服务器可提供内部网络与 Internet 之间的连接。 |
FileStore |
可选 |
开关参数 |
返回有关您组织中使用的文件存储的信息。文件存储用于保存 Lync Server 文件,如通知服务使用的音频文件。 |
ManagementServer |
可选 |
开关参数 |
返回有关您组织中使用的中央管理服务器的信息。中央管理服务器通常与前端服务器并置在一起,并负责访问中央管理存储中的信息。 |
MediationServer |
可选 |
开关参数 |
返回有关您组织中使用的中介服务器的信息。中介服务器可帮助提供企业语音网络和公用电话交换网 (PSTN) 之间的网桥。 |
MonitoringServer |
可选 |
开关参数 |
返回有关您组织中使用的监控服务器的信息。监控服务器用于跟踪企业语音电话用法和呼叫质量。 |
MonitoringDatabase |
可选 |
开关参数 |
返回有关您组织中使用的监控数据库的信息。监控数据库可存储企业语音电话用法和呼叫质量的信息。 |
PoolFqdn |
可选 |
字符串 |
用于托管服务或服务器角色的池的完全限定域名 (FQDN)。如果您使用 PoolFqdn 参数,而不指定特定于服务的参数,那么将返回该池上的所有服务和服务器角色。 |
ProvisionServer |
可选 |
开关参数 |
返回有关您组织中使用的设置服务器服务的信息。设置服务器服务用于管理 Lync Server 证书。 |
ProvisionDatabase |
可选 |
开关参数 |
返回有关您组织中使用的设置数据库的信息。设置数据库可保存有关 Lync Server 证书的信息。 |
PstnGateway |
可选 |
开关参数 |
返回有关您组织中使用的公用电话交换网 (PSTN) 网关的信息。PSTN 网关可将来自企业语音设备的信号转换为 PSTN 设备可以识别的信号,反之亦然。 |
Registrar |
可选 |
开关参数 |
返回有关您组织中使用的注册器的信息。注册器用于验证用户身份并跟踪用户的当前状态。 |
TrustedApplicationPool |
可选 |
开关参数 |
返回有关您组织中使用的受信任应用程序池的信息。受信任应用程序池可托管运行受信任应用程序的计算机。 |
UserDatabase |
可选 |
开关参数 |
返回有关您组织中使用的用户数据库的信息。用户数据库可存储用户服务器服务所需的数据。 |
UserServer |
可选 |
开关参数 |
返回有关您组织中使用的用户服务服务的信息。用户服务服务可提供诸如用户复制、带内设置、状态发布和通知以及联系人卡片交换等功能。 |
WebServer |
可选 |
开关参数 |
返回有关您组织中使用的Web 服务服务的信息。Web 服务服务用于托管基于 Web 的应用程序,如通讯簿服务。 |
输入类型
无。Get-CsService 不接受通过管道传递的输入。
返回类型
Get-CsService 可返回不同的对象,具体取决于调用该 cmdlet 时使用的参数。例如,如果包含 MonitoringDatabase 参数,Get-CsService 返回 Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase 对象的实例。要确定使用其他参数时返回的对象,请使用其中一个参数调用 Get-CsService,然后将返回的对象通过管道传递到 Get-Member cmdlet。例如:Get-CsService -Registrar | Get-Member。
示例
-------------------------- 示例 1 --------------------------
Get-CsService
示例 1 中显示的命令返回有关您组织中当前正在运行的所有 Lync Server 2010 服务和服务器角色的信息。
-------------------------- 示例 2 --------------------------
Get-CsService -ApplicationServer
示例 2 仅返回有关应用程序服务的信息。只需使用相应的参数即可返回其他服务/服务器角色的信息。例如,以下命令可返回有关文件存储的信息:
Get-CsService -FileStore
-------------------------- 示例 3 --------------------------
Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity
上述命令报告位于 atl-cs-001.litwareinc.com 池中的每个服务的 Identity。为完成此任务,该命令首先调用 Get-CsService 和 PoolFqdn 参数仅返回 atl-cs-001.litwareinc.com 池中的服务和服务器角色。然后,将该集合通过管道传递到 Select-Object cmdlet,该 cmdlet 会报告集合中每一项的 Identity。
-------------------------- 示例 4 --------------------------
Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}
在示例 4 中,返回 Redmond 站点上的所有服务/服务器角色的信息。为执行此操作,首先调用不带任何参数的 Get-CsService 以返回组织中当前正在使用的所有服务和服务器角色的集合。然后,将此数据通过管道传递到 Where-Object cmdlet,后者将仅挑选出 SiteID 属性等于 site:Redmond 的项。
-------------------------- 示例 5 --------------------------
Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}
示例 5 中显示的命令返回将注册器列为相关服务的所有服务的信息。为执行此操作,调用 Get-CsService 以返回当前正在使用的所有服务和服务器角色的集合。然后,将该集合通过管道传递到 Where-Object,后者将选择 DependentServiceList 属性包含字符串值“Registrar”的每一项。使用 -like 运算符和通配符值“*Registrar*”指定 Where-Object 条件。