Remove-CsProxyConfiguration
上一次修改主题: 2012-03-25
删除现有的代理服务器配置设置集合。
语法
Remove-CsProxyConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 用于通过代理服务器配置设置来管理代理服务器。这些设置可在 global 作用域和 service 作用域(但仅限边缘服务器和 Registrar 服务)应用,用于控制可供客户端终结点使用的身份验证协议以及是否将在传入和传出代理服务器连接上使用压缩等设置。当安装 Lync Server 2010 时,系统将自动为您创建代理服务器配置设置的全局集合。如前所述,您也可以在 service 作用域创建其他集合。
可在以后使用 Remove-CsProxyConfiguration cmdlet 删除您创建的任何新代理服务器设置。还可以对全局集合运行 Remove-CsProxyConfiguration。但是在这种情况下,将不会删除全局设置,原因是 Lync Server 不允许您删除全局设置。全局集合中的所有属性都将重置为其默认值。例如,代理服务器设置在默认情况下允许客户端使用 Kerberos 协议进行身份验证。您可以将全局设置更改为禁止使用 Kerberos。但是,如果您针对全局集合运行 Remove-CsProxyConfiguration,则相关属性 (UseKerberosForClientToProxyAuth) 将重置为其默认值,并将再次启用 Kerberos 作为身份验证协议。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsProxyConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsProxyConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的代理服务器配置设置的唯一标识符,例如:-Identity "service:Registrar:atl-cs-001.litwareinc.com"。 此外,也可以针对全局设置运行 Remove-CsProxyConfiguration。但是在这种情况下,将不会删除设置。该全局集合中的属性都将重置为其默认值。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 对象。Remove-CsProxyConfiguration 接受通过管道传递的代理设置对象的实例。
返回类型
无。Remove-CsProxyConfiguration 删除 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com
示例 1 中显示的命令删除 Identity 为 service:EdgeServer:atl-edge-litwareinc.com 的代理配置设置。
-------------------------- 示例 2 --------------------------
Get-CsProxyConfiguration -Filter "service:*" | Remove-CsProxyConfiguration
在示例 2 中,将删除在 service 作用域应用的所有代理配置设置。为了完成此任务,该命令首先调用带有 Filter 参数的 Get-CsProxyConfiguration。(筛选器值“service:*”确保只有 Identity 以字符串值“service:”开头的代理设置设置。然后,将筛选出的集合通过管道传递到 Remove-CsProxyConfiguration,后者会删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration
上述命令删除将所有客户端视为远程客户端的任何代理配置设置。为此,首先调用了 Get-CsProxyConfiguration(不带任何参数),以返回当前使用的所有代理服务器配置设置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会仅选择 TreatAllClientsAsRemote 属性等于 True 的设置。接下来,将该代理配置设置子集通过管道传递到 Remove-CsProxyConfiguration,后者会删除集合中的所有设置。