Get-CsSite
上次修改主題的時間： 2012-03-23
傳回當作 Microsoft Lync Server 2010 基礎結構一部分而建立之網站的相關資訊。網站表示 Lync Server 2010 集區的集合，通常是根據地理區域來設計。Lync Server 包括兩種網站類型：資料中心網站和遠端網站 (分公司網站)。
語法
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
詳細描述
Lync Server 2010 引進 Lync Server 拓撲的新概念：網站。網站 (請勿與 Active Directory 網站或 Microsoft Exchange Server 網站混淆) 是指通常根據地理區和網路頻寬來組織的 Lync Server 集區和伺服器的集合。例如，如果您在 Redmond 的所有電腦均位於具備高速、低延遲連線的相同區域網路上，則可能會指定包含這些電腦的 Redmond 網站。如果您在 Dublin 的電腦位於自己的區域網路中，並共用高速、低延遲的連線，則您也可以建立一個獨立的 Dublin 網站。網站在 Lync Server 管理中扮演了一個關鍵角色：大多數的原則和設定都可設定於網站範圍上，以方便進行像是將一組撥號對應表套用至位於 Redmond 的使用者並將完全不同的另一組撥號對應表套用至位於 Dublin 之使用者的作業。
Get-CsSite 指令程式可讓您傳回關於組織中所有網站的資訊，包括關於組成這些每個網站之集區的資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsSite Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSite"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
網站 Id |
要傳回之網站的名稱。請注意，您應該只指定網站名稱；例如：-Identity "Redmond"。在指定 Identity 時，請勿使用 "site:Redmond" 的格式。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的網站 Identity 時使用萬用字元。例如，此語法會傳回 Identity 包含字串值 "Dublin" 的所有集區：-Filter "*Dublin*"。 請注意，您無法在同一個命令中使用 Filter 和 Identity。 |
輸入類型
無。Get-CsSite 不接受管線傳送的輸入。
傳回類型
Get-CsSite 會傳回 Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsSite
範例 1 會擷取所有 Lync Server 網站的資訊。
-------------------------- 範例 2 --------------------------
Get-CsSite -Identity "Redmond"
在範例 2 中，會傳回單一網站的資訊：Identity 為 Redmond 的網站。
-------------------------- 範例 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
範例 3 所示的命令會傳回您中央網站的資訊。若要執行此工作，此命令會先呼叫 Get-CsSite 以傳回設定用於組織之所有網站的集合。接著，此集合會傳送到 Where-Object，這會挑出 SiteType 屬性等於 "CentralSite" 的一個網站。
-------------------------- 範例 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
以上的命令會顯示在 Redmond 網站中找到之集區的清單。為此，此命令會先擷取 Redmond 網站的完整資訊，然後將該資料傳送到 Select-Object 指令程式。接下來，Select-Object 會使用 ExpandProperty 參數來「展開」Pools 屬性的值。展開內容值表示在畫面上以易於閱讀的格式，顯示該內容中儲存的所有值。