Get-CsSimpleUrlConfiguration
上一次修改主题: 2012-03-23
返回有关配置为在组织中使用的简单 URL 的信息。简单 URL 既便于用户参加会议,又便于管理员登录到 Microsoft Lync Server 2010 控制面板 控制面板。
语法
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
详细说明
在 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。
通过 Get-CsSimpleUrlConfiguration cmdlet,您可以检索组织中当前使用的所有简单 URL 配置集合的相关信息。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsSimpleUrlConfiguration cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSimpleUrlConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的简单 URL 的集合的唯一标识符。要返回全局集合,请使用语法:-Identity global。要从站点作用域返回集合,请使用类似语法:-Identity "site:Redmond"。请注意,指定 Identity 时不能使用通配符。如果要使用通配符,请改用 Filter 参数。 调用不带任何参数的 Get-CsSimpleUrlConfiguration 会返回所有配置为在组织中使用的简单 URL。 |
Filter |
可选 |
字符串 |
使您能够使用通配符来指定要返回的某个简单 URL 集合(或多个集合)。例如,此语法将返回已在 site 作用域配置的所有简单 URL 集合:-Filter "site:*"。 请注意,不能在同一个命令中同时使用 Filter 和 Identity 参数。 |
Tenant |
可选 |
全局唯一标识符 |
此参数不用于 Lync Server 2010 的内部部署版本。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本,而非中央管理存储本身检索简单 URL 配置数据。 |
输入类型
无。
返回类型
Get-CsSimpleUrlConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Get-CsSimpleUrlConfiguration
上述命令将返回组织中当前使用的所有简单 URL 配置集合的信息。这可以通过调用不带任何其他参数的 Get-CsSimpleUrlConfiguration 来实现。
-------------------------- 示例 2 ------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
在示例 2 中,单个简单 URL 配置集合将返回下面的信息:Identity 为 site:Redmond 的配置。
-------------------------- 示例 3 ------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
示例 3 将返回已分配给站点作用域的所有简单 URL 配置集合的信息。为实现此操作,调用了带 Filter 参数的 Get-CsSimpleUrlConfiguration;筛选器值“site:*”会将返回的数据限制为 Identity 以字符串值“site:”开头的集合。
-------------------------- 示例 4 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
在示例 4 中,显示每个配置为在组织中使用的简单 URL 的详细信息。为实现此任务,命令首先调用 Get-CsSimpleUrlConfiguration 以返回一组完整的简单 URL 信息。然后将此数据通过管道传递到 Select-Object cmdlet,该 cmdlet 使用 ExpandProperty 参数“展开”SimpleUrl 属性的值。展开属性值会以易于阅读的方式显示存储在该属性中的所有数据。
-------------------------- 示例 5 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
示例 5 中显示的命令将返回组织中当前使用的会议管理的所有简单 URL。为执行此操作,命令首先调用不带任何其他参数的 Get-CsSimpleUrlConfiguration;这将返回一组完整的简单 URL 信息。然后将此数据通过管道传递到 Select-Object cmdlet,该 cmdlet 使用 ExpandProperty 参数展开 SimpleUrl 属性的值。然后,将此筛选出的集合通过管道传递到 Where-Object,后者将仅选取 Component 属性等于“Meet”的简单 URL。