Get-CsNetworkSite
上一次修改主题: 2012-03-23
检索为呼叫允许控制 (CAC) 或增强型 911 (E9-1-1) 定义的一个或多个网络站点。
语法
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
网络站点是指在部署了 CAC 或 E9-1-1 的每个区域中配置的办公室或位置。此 cmdlet 可检索一个或多个现有站点的设置。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsNetworkSite cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSite"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
XdsGlobalRelativeIdentity |
要检索的网络站点的唯一标识符。站点只能在 global 作用域创建,因此不需要指定作用域,只需要指定站点 ID。(请注意,该值与网络站点的 NetworkSiteID 相同。) |
Filter |
可选 |
字符串 |
一个通配符字符串,使您可以通过将站点 Identity 与 Filter 匹配来检索多个站点。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本,而不是从中央管理存储本身检索网络站点信息。 |
输入类型
无。
返回类型
检索一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsNetworkSite
调用不带任何参数的 Get-CsNetworkSite 将返回 Microsoft Lync Server 2010 部署中为 CAC 或 E9-1-1 配置的所有网络站点。
-------------------------- 示例 2 --------------------------
Get-CsNetworkSite -Identity Redmond
此命令检索 Identity(根据定义,即 NetworkSiteID)为 Redmond 的站点。
-------------------------- 示例 3 --------------------------
Get-CsNetworkSite -Filter NA*
示例 3 中的命令调用带有 Filter 参数的 Get-CsNetworkSite。Filter 参数的值为 NA*,这意味着此命令将检索 Identity 以字符串 NA 开头且后跟有任意数目的字符的所有站点。这将返回 NARedmond、NAVancouver 和 NAChicago 等站点。
-------------------------- 示例 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
示例 4 使用两个 cmdlet(即 Get-CsNetworkSite 和 Where-Object)来检索作为 NorthAmerica 区域的一部分的所有站点。该命令首先调用不带任何参数的 Get-CsNetworkSite,以检索所有网络站点。然后,将该站点集合通过管道传递到 Where-Object,后者会对该集合进行筛选,并在 NetworkRegionID 属性等于 (-eq) NorthAmerica 的集合中查找所有站点。