Remove-CsSimpleUrlConfiguration

 

上一次修改主题: 2012-03-26

删除一个或多个组织中当前使用的简单 URL 配置集合。简单 URL 既便于用户参加会议,又便于管理员登录到 Microsoft Lync Server 2010 控制面板 控制面板。

语法

Remove-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

详细说明

在 Microsoft Office Communications Server 2007 R2 中,会议具有类似如下的 URL:

https://imdf.litwareinc.com/Join?uri=sip%3Akenmyer%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8\&key=EcznhLh5K5t

但是,此类 URL 不是特别直观,也不易于传送给其他用户。Lync Server 2010 中引入的简单 URL 可帮助解决以上问题,方法是为用户提供与下面类似的 URL:

https://meet.litwareinc.com/kenmyer/071200

简单 URL 是对 Office Communications Server 中使用的 URL 的一项改进。但是,简单 URL 不会自动创建;您必须自己配置 URL。此外,您还必须执行为每个 URL 创建域名系统 (DNS) 记录、为外部访问配置反向代理规则以及向前端服务器证书添加简单 URL 等操作。

Lync Server 中可创建三种不同的简单 URL:

Meet – 用于会议。每个 SIP 域必须至少有一个 Meet URL。

Admin – 用于将管理员定向到 Lync Server 2010 控制面板。

Dialin – 用于电话拨入式会议网页。

简单 URL 存储在简单 URL 配置集合中。在安装 Lync Server 时,会为您创建一个全局集合;您还可以在 site 作用域创建自定义集合。这样,您可以在每个站点上使用不同的简单 URL。

简单 URL 配置集合可以使用 New-CsSimpleUrlConfiguration cmdlet 创建,然后您可以使用其他 cmdlet(如 New-CsSimpleUrlEntrySet-CsSimpleUrlConfiguration)将简单 URL 填入这些集合。如果随后决定删除一个或多个 site 作用域集合,则可以通过使用 Remove-CsSimpleUrlConfiguration cmdlet 完成。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsSimpleUrlConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsSimpleUrlConfiguration"}

参数

参数 必需 类型 描述

Identity

必需

Xds 标识

要删除的简单 URL 集合的唯一标识符。要从站点作用域删除集合,请使用与此类似的语法:-Identity "site:Redmond"。请注意,指定 Identity 时不能使用通配符。

还可以使用以下语法针对全局集合运行此 cmdlet:-Identity global。但在这种情况下,不会删除全局集合。而是删除该集合中的所有简单 URL。

Tenant

可选

Guid

此参数不适用于 Lync Server 2010 的内部版本。

Force

可选

开关参数

禁止显示运行此命令时可能出现的任何非严重错误消息。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

开关参数

在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration 对象。Remove-CsSimpleUrlConfiguration 接受通过管道传递的简单 URL 配置对象的实例。

返回类型

无。

示例

-------------------------- 示例 1 ------------------------

Remove-CsSimpleUrlConfiguration -Identity "site:Redmond"

示例 1 中显示的命令将删除应用于 Redmond 站点的简单 URL 配置集合。此命令删除分配给指定站点的所有简单 URL。

-------------------------- 示例 2 ------------------------

Get-CsSimpleUrlConfiguration -Filter "site:*" | Remove-CsSimpleUrlConfiguration 

在示例 2 中,删除应用于 site 作用域的所有简单 URL 配置集合。为执行此操作,该命令首先使用 Get-CsSimpleUrlConfiguration 和 Filter 参数返回在 site 作用域配置的所有简单 URL 集合;筛选器值“site:*”会将返回的数据限制为其 Identity 以字符串值“site:”开头的集合。然后将筛选出的集合通过管道传递到 Remove-CsSimpleUrlConfiguration,后者会删除集合中的每一项。