New-CsSimpleUrl
上一次修改主题： 2012-10-17
创建新的简单 URL，然后可将其添加到简单 URL 配置集合。简单 URL 既便于用户参加会议，又便于管理员登录到 Microsoft Lync Server 2010 控制面板。
语法
New-CsSimpleUrl -Component <String> -Domain <String> [-ActiveUrl <String>] [-SimpleUrlEntry <PSListModifier>]
详细说明
在 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 集合添加实际 URL，必须首先用 New-CsSimpleUrl 和 New-CsSimpleUrlEntry cmdlet 创建该 URL。New-CsSimpleUrlEntry cmdlet 创建 URL 项：即可用作简单 URL（用于会议、管理或电话拨入式会议用途）的 URL（如 https://meet.litwareinc.com）。将 New-CsSimpleUrlEntry 创建的对象添加到新简单 URL 的 SimpleUrlEntry 属性。必须使用一个单独的 cmdlet 创建该对象，因为 SimpleUrlEntry 属性可容纳多个 URL。（但是，只能指定一个此类 URL 作为活动 URL。活动 URL 表示用于会议、管理或电话拨入式会议的真实 URL。）
创建简单 URL 项之后，用 New-CsSimpleUrl cmdlet 创建简单 URL 的仅内存中实例，并将其定义为组件（简单 URL 的类型）、域、活动 URL 以及所有简单 URL 项等。创建表示简单 URL 的对象之后，可将该对象添加到新的（或现有）简单 URL 集合。在更新简单 URL 集合之后，您必须运行 Enable-CsComputer cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsSimpleUrl cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSimpleUrl\b"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Component |
必需 |
字符串 |
指示所创建的简单 URL 的类型。有效值包括： Meet - 用于管理会议的 URL。 Admin – 指向 Lync Server 2010 控制面板的 URL。 Dialin - 用于电话拨入式会议的 URL。 例如：-Component "Meet"。 |
Domain |
必需 |
字符串 |
简单 URL 的 SIP 域。例如：-Domain "litwareinc.com"。 |
SimpleUrlEntry |
可选 |
PS 列表修饰符 |
指定组件 URL 的集合。例如，可以将 https://meet.litwareinc.com 和 https://litwareinc.com/meet 配置为 Meet 组件的 URL 项。但是，只能（并且必须）将其中的一个 URL 配置为活动 URL。 必须使用 New-CsSimpleUrlEntry cmdlet 创建简单 URL 项。 |
ActiveUrl |
可选 |
字符串 |
指示用户实际要访问的 URL。SimpleUrlEntry 属性包含多个 URL，但只有一个 URL 可在给定时间处于活动状态。如果尝试将 ActiveUrl 设置为 SimpleUrlEntry 属性中未找到的值，则将发生错误。 要分配活动 URL，使用 URL 自身作为参数值即可。例如：-ActiveUrl https://meet.litwareinc.com"。 |
输入类型
无。New-CsSimpleUrl 不接受通过管道传递的数据。
返回类型
New-CsSimpleUrl 创建 Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrl 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}
上述示例说明了如何向现有的简单 URL 集合中添加新的 URL。首先，示例中的第一个命令使用 New-CsSimpleUrlEntry 创建一个指向 https://meet.fabrikam.com 的 URL 条目，此 URL 条目存储在名为 $urlEntry 的变量中。
在第二个命令中，New-CsSimpleUrl 用于创建简单 URL 的仅保存在内存中的实例。在此示例中，将 URL 组件设置为 Meet，将域设置为 fabrikam.com，将 ActiveUrl 设置为 https://meet.fabrikam.com，并将 SimpleUrlEntry 属性设置为 $urlEntry，而 $urlEntry 是第一个命令中创建的 URL 项。
创建 URL（并存储在对象引用 $simpleUrl 中）之后，示例中的最后一个命令将这个新 URL 添加到 Redmond 站点的简单 URL 集合。这是通过使用 Set-CsSimpleUrlConfiguration cmdlet、SimpleUrl 参数和参数值 @{Add=$simpleUrl} 来实现的。此语法表示对象引用 $simpleUrl 中存储的 URL 将添加到 SimpleUrl 属性。