Get-CsSite
上一次修改主题: 2012-03-23
返回有关作为 Microsoft Lync Server 2010 基础结构一部分创建的站点的信息。站点代表 Lync Server 2010 池的集合,通常根据地理区域设计。Lync Server 包括两种站点类型:数据中心站点和远程站点(分支站点)。
语法
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
详细说明
Lync Server 2010 为 Lync Server 拓扑引入了一个新概念:站点。站点(不要与 Acitve Directory 站点或 Microsoft Exchange Server 站点混淆)指通常根据地理位置和网络带宽进行组织的 Lync Server 池和服务器的集合。例如,如果 Redmond 的所有计算机都位于相同的局域网,并且具有高速度低延迟的连接,则可以指定包含这些计算机的 Redmond 站点。如果 Dublin 的计算机位于其自己的局域网上,并且共享高速、低延迟的连接,则还可以创建独立的 Dublin 站点。站点在 Lync Server 管理中起到关键作用:可以在 site 作用域配置大部分策略和设置,这样便于执行如下操作:将一组拨号计划应用于 Redmond 的用户,并将另一组完全不同的拨号计划应用于 Dublin 的用户。
使用 Get-CsSite cmdlet 可返回有关组织中所有站点的信息,其中包括有关组成每个这些站点的各个池的信息。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsSite cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSite"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
站点 Id |
要返回的站点的名称。注意,只应指定站点名称;例如:-Identity "Redmond"。指定 Identity 时,请不要使用“site:Redmond”格式。 |
Filter |
可选 |
字符串 |
使您在指定要返回的站点的 Identity 时可使用通配符。例如,此语法返回 Identity 包括字符串值“Dublin”的所有池:-Filter "*Dublin*"。 请注意,不能在同一个命令中同时使用 Filter 和 Identity。 |
输入类型
无。Get-CsSite 不接受通过管道传递的输入。
返回类型
Get-CsSite 返回 Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsSite
示例 1 检索所有 Lync Server 站点的信息。
-------------------------- 示例 2 --------------------------
Get-CsSite -Identity "Redmond"
示例 2 中返回单个站点的信息:即 Identity 为 Redmond 的站点。
-------------------------- 示例 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
示例 3 中显示的命令返回中央站点的信息。为实现此任务,该命令首先调用 Get-CsSite 返回配置为在组织中使用的所有站点的集合。然后,将此集合通过管道传递给 Where-Object,后者选取 SiteType 属性等于“CentralSite”的那个站点。
-------------------------- 示例 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
上述命令显示 Redmond 站点中找到的池的列表。为执行此操作,该命令首先检索 Redmond 站点的完整信息,然后将这些数据通过管道传递给 Select-Object cmdlet。接下来,Select-Object 使用 ExpandProperty 参数“展开”Pools 属性的值。扩展属性值意味着将在屏幕上以易读格式显示该属性中存储的所有值。