Get-CsNetworkRegionLink
上次修改主題的時間： 2012-03-23
在針對通話許可控制 (CAC) 所設定的網路區域之間，擷取一或多個連結。
語法
Get-CsNetworkRegionLink [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkRegionLink [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
網路之中的地區是透過實體 WAN 連線相連結。這個指令程式會擷取定義於 Microsoft Lync Server 2010 部署之網路組態設定內的一或多個區域連結。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkRegionLink Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkRegionLink"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsGlobalRelativeIdentity |
您要擷取之網路區域連結的唯一識別碼。網路區域連結只會建立在全域範圍，因此不需要為此識別碼指定範圍。而是用它包含的唯一名稱字串來識別該連結。(請注意，這個值與 NetworkRegionLinkID 相同)。 |
Filter |
選用 |
字串 |
根據與萬用字元字串相符的 Identity 值，接受用來擷取網路連結的萬用字元字串。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取網路區域連結資訊，而不是從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
擷取 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType 類型的一或多個物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsNetworkRegionLink
範例 1 會擷取定義於 Lync Server 2010 部署中的所有網路區域連結。
-------------------------- 範例 2 --------------------------
Get-CsNetworkRegionLink -Identity NA_EMEA
範例 2 會擷取 (最多) 一個網路區域連結 (與 Identity NA_EMEA 的連結) 的相關資訊。
-------------------------- 範例 3 --------------------------
Get-CsNetworkRegionLink -Filter *EMEA*
在此範例中，我們會使用 Filter 參數擷取其連結名稱 (Identity) 中包含字串 EMEA 的所有網路區域連結。請注意，* 字元一個在字串 EMEA 之前，一個在之後。這表示任何字元皆可以放在字串的前後；字串 EMEA 只是必須內含於 Identity 中的某處即可。這將會擷取含名稱的連結，例如，NA_EMEA、EMEA_APAC，與 EMEA2_SA。
-------------------------- 範例 4 --------------------------
Get-CsNetworkRegionLink | Where-Object {$_.NetworkRegionID1 -eq "EMEA" -or $_.NetworkRegionID2 -eq "EMEA"}
此範例會擷取包含 EMEA 作為已連結兩個區域之其中一個的所有網路區域連結。範例先呼叫 Get-CsNetworkRegionLink 且不用任何其他參數，其將會擷取所有區域連結。然後將此連結集合傳送給 Where-Object 指令程式。Where-Object 會逐一查看集合的每個成員，檢查 NetworkRegionID1 與 NetworkRegionID2 屬性的值。如果其中一個屬性等於 EMEA -- 亦即若 NetworkRegionID1 等於 (-eq) EMEA 或 (-or) NetworkRegionID2 等於 (-eq) EMEA -- 則我們會將該項目保留於集合中並顯示。