Get-CsNetworkSubnet
上次修改主題的時間： 2012-03-23
擷取一或多個網路子網路的資訊。
語法
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
為了判斷屬於此子網路的主機地理位置，每一個子網路都必須與網路站台相關聯。使用此指令程式擷取子網路的相關資訊，包括 Identity (子網路 ID)、遮罩位元數、關聯的網路站台及子網路的描述。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkSubnet Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSubnet"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsGlobalRelativeIdentity |
您要擷取的子網路的唯一子網路 ID。這個值為 IP 位址 (例如 174.11.12.0)。 |
Filter |
選用 |
字串 |
使用此參數根據 Identity 對所有子網路執行萬用字元搜尋。例如，篩選值 172.11.* 將擷取所有 Identity 以 172.11 開頭的子網路 (如 172.11.10.0、172.11.25.0 等)。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取網路子網路資訊，而不是從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
傳回一或多個 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsNetworkSubnet
此範例擷取 Microsoft Lync Server 2010 部署內的所有子網路。
-------------------------- 範例 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
此範例會擷取 Identity (子網路 ID) 為 172.11.15.0 的子網路的所有資訊。
-------------------------- 範例 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
此範例會擷取 Identity 以 172.11. 開頭的所有子網路。
-------------------------- 範例 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
範例 4 擷取所有與 Vancouver 站台關聯的子網路。我們先呼叫 Get-CsNetworkSubnet 指令程式且不搭配任何參數，如同在範例 2 中所見，這會擷取所有定義的子網路。接著我們將這個子網路集合傳送給 Where-Object 指令程式。Where-Object 採用該集合並縮小範圍至只有 NetworkSiteID 等於 (-eq) Vancouver 的子網路。