Get-CsNetworkSite
上次修改主題的時間： 2012-03-23
擷取一或多個針對通話許可控制 (CAC) 或增強型 9-1-1 (E9-1-1) 所定義的網路站台。
語法
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
網路站台是指在 CAC 或 E9-1-1 部署的每一個區域內設定的辦公室或位置。此指令程式會擷取一或多個現有網路站台的設定。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkSite Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSite"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsGlobalRelativeIdentity |
您要擷取之網路站台的唯一識別碼。只會在全域範圍建立站台，所以您不必指定範圍。而只需要指定站台 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 的命令會呼叫 Get-CsNetworkSite 搭配 Filter 參數。Filter 參數的值為 NA*，表示此命令將擷取 Identity 以 NA 字串開頭且後面有任意字元數量的所有站台。這將傳回 NARedmond、NAVancouver 和 NAChicago 這類的站台。
-------------------------- 範例 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
範例 4 會使用兩個指令程式 (Get-CsNetworkSite 和 Where-Object) 擷取所有在 NorthAmerica 區域的站台。此命令會以呼叫沒有參數的 Get-CsNetworkSite 來擷取所有網路站台作為開始。然後，將此站台集合傳送至 Where-Object，由其篩選集合以尋找集合中所有 NetworkRegionID 屬性等於 (-eq) NorthAmerica 的站台。