New-CsSimpleUrlConfiguration
上一次修改主题： 2012-10-17
创建新的简单 URL 配置集合。简单 URL 既便于用户参加会议，又便于管理员登录到 Microsoft Lync Server 2010 控制面板。
语法
New-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-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 域必须至少具有一个会议 URL。
Admin – 用于将管理员定向到 Lync Server 2010 控制面板。
Dialin – 用于电话拨入式会议网页。
简单 URL 存储在简单 URL 配置集合中。在安装 Lync Server 时，会为您创建一个全局集合；您还可以在 site 作用域创建自定义集合。这样，您可以在每个站点上使用不同的简单 URL。
简单 URL 配置集合可以使用 New-CsSimpleUrlConfiguration cmdlet 创建，然后您可以使用其他 cmdlet（如 New-CsSimpleUrl 和 Set-CsSimpleUrlConfiguration）将简单 URL 填入这些集合。在更新简单 URL 集合之后，您必须运行 Enable-CsComputer cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsSimpleUrlConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSimpleUrlConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
新的简单 URL 配置集合的唯一标识符。由于只能在 site 作用域创建新集合，因此 Identity 必须以“site:”为前缀，后跟站点的名称。例如，以下语法为 Redmond 站点创建一个新集合：-Identity "site:Redmond"。 |
SimpleUrl |
可选 |
PS 列表修饰符 |
已为该集合配置的简单 URL。必须使用 New-SimpleUrl 和 New-SimpleUrlEntry cmdlet 创建这些 URL。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
Tenant |
可选 |
Guid |
此参数不用于 Lync Server 的内部部署版本。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
New-CsSimpleUrlConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsSimpleUrlConfiguration -Identity "site:Redmond"
示例 1 中显示的命令为 Redmond 站点创建一个新的简单 URL 集合。由于此命令不包含 Identity 之外的任何其他参数，因此该新集合将不包含任何简单 URL。如果 Redmond 站点已托管一个简单 URL 集合，该命令将失败。
-------------------------- 示例 2 --------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrlEntry $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2
New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}
上述示例演示如何创建一个新的简单 URL 集合，其中包含两个简单 URL（一个用于会议管理，一个用于电话拨入式会议）。为执行此操作，示例中的第一个命令使用 New-CsSimpleUrlEntry 创建一个指向 https://dialin.litwareinc.com 的 URL 项；此 URL 项存储在名为 $urlEntry 的变量中。然后，第二个命令创建另一个 URL 条目，该条目指向 https://meet.fabrikam.com。
接下来，New-CsSimpleUrl cmdlet 用于创建简单 URL 的仅保存在内存中的实例。在此示例中，URL 组件设置为 Dialin，域设置为星号 (*)，ActiveUrl 设置为 https://dialin.fabrikam.com，SimpleUrl 属性设置为 $urlEntry。（变量 $urlEntry 代表在第一个命令中创建的 URL 条目。）然后，使用一个类似的命令为 meet.fabrikam.com 创建一个简单 URL。
在创建 URL（并将其存储在对象引用 $simpleUrl 和 $simpleUrl2 中）之后，示例中的最后一个命令为 Redmond 站点创建一个新的简单 URL 集合，并将两个新的仅保存在内存中的 URL 添加到该集合中。使用 New-CsSimpleUrlConfiguration cmdlet、SimpleUrl 参数和参数值 @{Add=$simpleUrl, $simpleUrl2} 将新 URL 添加到该集合中。该语法将使存储在对象引用 $simpleUrl 和 $simpleUrl2 中的 URL 添加到 SimpleUrl 属性中。