Get-CsNetworkRegion
上次修改主題的時間： 2012-03-23
擷取一或多個網路區域。網路區域表示企業網路中的網路集線器或骨幹。
語法
Get-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkRegion [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
網路區域會與跨多個地理區域的網路不同部分交互連線。每個網路區域都必須與中央站台產生關聯。使用此指令程式來擷取一個或多個網路區域的相關資訊 (包括相關聯的中央網站)、擷取判斷是否允許針對音訊和視訊連線使用替代路徑的設定，以及將該區域內的站台與媒體旁路組態產生關聯的設定。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkRegion Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkRegion"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 通用相對識別碼 |
您要擷取之網路區域的唯一識別碼。Identity 的格式會是可唯一識別該區域的字串 (請注意，Identity 與 NetworkRegionID 相同)。 |
Filter |
選用 |
字串 |
此參數可讓您針對為組織設定之所有網路區域的 Identity 執行萬用字元搜尋。使用萬用字元針對 Identity 的任何部分進行篩選。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取網路區域資訊，而非從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
傳回 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 類型的一個或多個物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsNetworkRegion
範例 1 會擷取針對組織定義的所有網路區域。
-------------------------- 範例 2 --------------------------
Get-CsNetworkRegion -Identity NorthAmerica
範例 2 會擷取 Identity 為 NorthAmerica 的網路區域。因為 Identity 是唯一的，因此，此命令最多只會擷取一個網路區域。
-------------------------- 範例 3 --------------------------
Get-CsNetworkRegion -Filter *America
此範例會擷取 Identity 結尾為字串 "America" 的所有網路區域。這樣會擷取 Identity 為 NorthAmerica、SouthAmerica 以及 CentralAmerica 之類的區域。
-------------------------- 範例 4 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"}
此範例會擷取與 中央網站 相關聯的所有網路區域。命令一開始會先呼叫不含參數的 Get-CsNetworkRegion 指令程式，以擷取為 Microsoft Lync Server 2010 部署定義的所有網路區域集合。此集合會被傳送到 Where-Object 指令程式。Where-Object 會先篩選此集合，僅傳回 CentralSite 值等於 (-eq) Redmond 的項目 (網路區域)。