Get-CsServerApplication
上一次修改主题： 2012-03-23
返回有关组织中使用的服务器应用程序的信息。服务器应用程序是由 Microsoft Lync Server 2010 托管的应用程序。
语法
Get-CsServerApplication [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsServerApplication [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
服务器应用程序是指在 Lync Server 2010 下运行的各个程序。Get-CsServerApplication cmdlet 为管理员提供了一种方法，用于返回有关作为 Lync Server 的一部分运行的任何（或所有）应用程序的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsServerApplication cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsServerApplication"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的服务器应用程序的唯一标识符。服务器应用程序标识由托管应用程序的服务与应用程序名组成。例如，名为 QoEAgent 的服务器应用程序可能具有以下类似标识：service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 要检索在给定服务中运行的所有应用程序的集合，只需将应用程序名称留空： -Identity "Registrar:atl-cs-001.litwareinc.com " 如果省略此参数，则在调用 Get-CsServerApplication 时，将返回所有服务器应用程序。 |
Filter |
可选 |
字符串 |
使您可以在返回服务器应用程序或服务器应用程序组时使用通配符。例如，要返回 Identity 中某位置包含字符串值“IIMFilter”的所有服务器应用程序，请使用以下语法：-Filter "*IIMFilter*"。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索服务器应用程序数据。 |
输入类型
无。Get-CsServerApplication 不接受通过管道传递的输入。
返回类型
Get-CsServerApplication 返回 Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsServerApplication
示例 1 中显示的命令返回有关组织中当前使用的所有服务器应用程序的信息。这是通过调用不带任何参数的 Get-CsServerApplication 实现的。
-------------------------- 示例 2 --------------------------
Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"
在示例 2 中，将返回有关在服务 EdgeServer:atl-edge-001.litwareinc.com 中运行的所有服务器应用程序的信息。
-------------------------- 示例 3 --------------------------
Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"
示例 3 返回单个服务器应用程序的信息：Identity 为“Registrar:atl-cs-001.litwareinc.com/ExumRouting”的应用程序。
-------------------------- 示例 4 --------------------------
Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"
上述命令返回配置为在池 atl-cs-001.litwareinc.com 中使用的所有服务器应用程序。这是使用 Filter 参数和筛选器值“service:*:atl-cs-001.litwareinc.com*”实现的。该筛选器值将返回的数据限制为 Identity 以字符“service:”开头的应用程序且包括字符“:atl-cs-001.litwareinc.com”的应用程序。
-------------------------- 示例 5 --------------------------
Get-CsServerApplication | Where-Object {$_.Enabled -eq $False}
在示例 5 中，返回了当前已禁用的所有服务器应用程序的信息。为了执行此任务，该命令首先调用 Get-CsServerApplication，以返回配置为在组织中使用的所有服务器应用程序的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 Enabled 属性等于 False 的应用程序。
-------------------------- 示例 6 --------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $True -and $_.Enabled -eq $False}
示例 6 是示例 5 中显示的命令的变体。在示例 6 中，将返回标记为“关键”并且当前已禁用的所有服务器应用程序的信息。为执行此操作，该命令首先调用不带任何参数的 Get-CsServerApplication；这将返回配置为要使用的所有服务器应用程序的集合。然后，将该集合通过管道传递到 Where-Object，后者会仅挑选满足以下两个条件的应用程序：Critical 属性必须等于 True；以及 Enabled 属性必须等于 False。-and 运算符可确保仅返回满足这两个条件的对象。
-------------------------- 示例 7 --------------------------
Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}
在示例 7 中，将返回 URI 中某位置包含字符串值“routing”的所有服务器应用程序的信息。此任务是通过以下方式实现的：首先使用 Get-CsServerApplication 检索当前使用的所有服务器应用程序。然后，将生成的集合通过管道传递到 Where-Object，后者会仅选择 Uri 属性包括字符串值“routing”的应用程序。
-------------------------- 示例 8 --------------------------
Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}
上述命令返回已分配脚本的所有服务器应用程序的信息。为执行此操作，该命令首先检索当前使用的所有服务器应用程序的集合；通过调用不带任何参数的 Get-CsServerApplication 可检索该信息。然后，将服务器应用程序的完整集合通过管道传递到 Where-Object cmdlet，后者会仅选择 ScriptName 属性不等于空值的应用程序。如果 ScriptName 属性不等于空值，则意味着已为该应用程序分配了脚本。