Get-CsProxyConfiguration
上一次修改主题： 2012-03-23
返回有关组织中当前使用的代理服务器配置设置的信息。
语法
Get-CsProxyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
Microsoft Lync Server 2010 用于通过代理服务器配置设置来管理代理服务器。这些设置可在 global 作用域和 service 作用域（但仅限边缘服务器和 Registrar 服务）应用，用于控制可供客户端终结点使用的身份验证协议以及是否将在传入和传出代理服务器连接上使用压缩等设置。当安装 Lync Server 2010 时，系统将自动为您创建代理服务器配置设置的全局集合。如前所述，您也可以在 service 作用域创建其他集合。
Get-CsProxyConfiguration cmdlet 用于返回组织中当前使用的任何代理服务器配置设置的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsProxyConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsProxyConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的代理服务器配置设置的唯一标识符。要返回全局设置，请使用以下语法：-Identity global。要返回在 service 作用域配置的设置，请使用以下类似语法：-Identity "service:EdgeServer:atl-cs-001.litwareinc.com"。请注意，在指定 Identity 时不能使用通配符。如果要（或需要）使用通配符，请改用 Filter 参数。 如果未包括此参数，Get-CsProxyConfiguration 将返回组织中当前使用的所有代理服务器设置。 |
Filter |
可选 |
字符串 |
使您可以在指定要返回的代理配置设置时使用通配符。例如，以下语法返回在 service 作用域配置的所有设置：-Filter "service:*"。 不能在同一个命令中同时使用 Filter 和 Identity 参数。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索代理配置数据。 |
输入类型
无。Get-CsProxyConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsProxyConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsProxyConfiguration
示例 1 中显示的命令返回组织中当前使用的所有代理配置设置的集合。这是通过调用不带任何参数的 Get-CsProxyConfiguration 实现的。
-------------------------- 示例 2 --------------------------
Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"
在示例 2 中，返回有关 Identity 为 service:EdgeServer:atl-cs-001.litwareinc.com 的代理配置设置的信息。由于标识必须是唯一的，因此该命令返回的设置集合始终不会超过一个。
-------------------------- 示例 3 --------------------------
Get-CsProxyConfiguration -Filter "service:*"
上述命令返回有关已在 service 作用域配置的所有代理设置的信息。为此，该命令调用带有 Filter 参数的 Get-CsProxyConfiguration；筛选器值“service:*”可确保仅返回 Identity 以字符串值“service:”开头的设置。
-------------------------- 示例 4 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}
示例 4 返回有关不允许使用客户端证书作为身份验证机制的代理配置设置的信息。为了执行此任务，该命令首先使用 Get-CsProxyConfiguration 返回当前使用的所有代理配置设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 UseCertificateForClientToProxyAuth 属性等于 False 的设置。
-------------------------- 示例 5 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}
上述命令返回客户端消息的最大正文大小小于 5000 KB 的所有代理配置设置。为此，该命令首先调用不带任何参数的 Get-CsProxyConfiguration；这将返回当前使用的所有代理配置设置的集合。然后，将该集合通过管道传递到 Where-Object，后者会挑选出 MaxClientMessageBodySizeKb 属性小于 5000 KB 的设置。