Get-CsWebServiceConfiguration
上一次修改主题： 2012-03-23
返回有关组织中使用的所有 Web 服务配置设置的信息。
语法
Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
许多 Microsoft Lync Server 2010 组件都基于 Web：这些组件使用 Web 服务或网页来完成其任务。例如，用户在通讯簿中搜索新联系人，或者通过组展开来查看通讯组的各个成员时，可以使用 Web 服务。同样，范围从电话拨入式会议到 Microsoft Lync Server 2010 控制面板 的组件可使用网页作为 Lync Server 2010 与用户之间的界面。
通过 CsWebServiceConfiguration cmdlet，管理员可以管理整个组织中的 Web 服务配置设置，包括管理组扩展、证书设置和允许的身份验证方法。由于您可以在 global、site 和 service 作用域（但仅限“Web 服务”服务）配置不同的设置，因此可以为各个用户和各个位置自定义 Web 服务功能。
通过 Get-CsWebServiceConfiguration cmdlet，可以返回有关组织中当前使用的 Web 服务配置设置的详细信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsWebServiceConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWebServiceConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的 Web 服务配置设置的唯一标识符。要返回全局设置，请使用以下语法：-Identity global。要返回在 site 作用域配置的设置，请使用以下类似语法：-Identity "site:Redmond"。可以使用以下类似语法返回 Service 作用域设置：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 不能在同一个命令中同时使用 Filter 和 Identity 参数。如果未指定任一参数，Get-CsWebServiceConfiguration 将返回组织中当前使用的所有 Web 服务设置集合。 |
Filter |
可选 |
字符串 |
使您可以在指定要返回的 Web 服务配置设置集合时使用通配符。例如，以下语法返回在 site 作用域配置的所有设置：-Filter "site:*"。 不能在同一个命令中同时使用 Filter 和 Identity 参数。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索 Web 服务配置数据。 |
输入类型
无。Get-CsWebServiceConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsWebServiceConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsWebServiceConfiguration
上述命令返回有关组织中当前使用的所有 Web 服务配置设置的信息。
-------------------------- 示例 2 --------------------------
Get-CsWebServiceConfiguration -Identity site:Redmond
示例 2 中显示的命令返回有关 Identity 为 site:Redmond 的 Web 服务配置设置的信息。
-------------------------- 示例 3 --------------------------
Get-CsWebServiceConfiguration -Filter "site:*"
示例 3 返回在 site 作用域分配的所有 Web 服务配置设置。为此，在调用 Get-CsWebServiceConfiguration 时包含了 Filter 参数；筛选器值“site:*”可确保仅返回 Identity 以字符串值“site:”开头的设置。
-------------------------- 示例 4 --------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.UsePinAuth -eq $False}
在示例 4 中，该命令返回不允许个人标识号 (PIN) 身份验证的所有 Web 服务配置设置。这是通过以下方式实现的：首先调用 Get-CsWebServiceConfiguration 以返回当前使用的所有 Web 服务配置设置。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅挑选出 UsePinAuth 属性等于 False 的设置。
-------------------------- 示例 5 --------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}
上述命令返回最大组扩展大小超过 100 的所有 Web 服务配置设置。为执行此操作，该命令首先使用 Get-CsWebServiceConfiguration 返回当前使用的所有 Web 服务配置设置。然后，将该信息通过管道传递到 Where-Object cmdlet，后者会仅选择 MaxGroupSizeToExpand 属性大于 100 的设置。