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:
但是,此类 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-CsSimpleUrlEntry 和 Set-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,后者会删除集合中的每一项。