Set-CsSite
上次修改主題的時間： 2012-03-26
修改任一個 Microsoft Lync Server 2010 站台的屬性。站台表示 Lync Server 2010 集區的集合，通常是根據地理區域來設計。Lync Server 包括兩種站台類型：資料中心站台和遠端站台 (分公司)。
語法
Set-CsSite [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-FederationRoute <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Lync Server 2010 引進 Lync Server 拓撲的新概念：站台。站台 (請勿與 Active Directory 站台或 Microsoft Exchange Server 站台混淆) 是指通常根據地理區和網路頻寬來組織的 Lync Server 集區和伺服器的集合。例如，如果您在 Redmond 的所有電腦均位於具備高速、低延遲連線的相同區域網路上，則可能會指定包含這些電腦的 Redmond 站台。如果您在 Dublin 的電腦均位於他們自己的區域網路上，並共用高速、低延遲的連線，則可能也會建立個別的 Dublin 站台。站台也會在 Lync Server 管理中扮演一個關鍵角色：許多原則和設定都可設定於站台範圍上，以方便進行像是將一組撥號對應表套用至位於 Redmond 的使用者並將另一組撥號對應表套用至位於 Dublin 之使用者的作業。
站台可以使用 拓撲產生器 來建立，而任何對於站台基礎架構的變更 (例如，新增集區) 也必須使用 opology Builder 進行。但是，您可以使用 Set-CsSite 指令程式，來變更組織中任何站台的顯示名稱、描述和同盟路由。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsSite Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSite"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要修改的站台名稱；例如：-Identity "Redmond"。在指定 Identity 時，請勿使用 "site:Redmond" 的格式。 |
Description |
選用 |
字串 |
讓系統管理員可以為站台物件新增額外資訊。例如，Description 可能包括站台的連絡人資訊。 |
DisplayName |
選用 |
字串 |
站台的易記名稱。例如：-DisplayName "North America and South America"。 |
FederationRoute |
選用 |
字串 |
Edge Server 的服務位置，可用來提供內部網路與網際網路之間的橋接器。例如：-FederationRoute "EdgeServer:atl-edge-001.litwareinc.com"。 |
Force |
選用 |
切換參數 |
隱藏當您執行 Cmdlet 時可能發生的任何確認提示字元或非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Set-CsSite 不會接受管線傳送的資料。
傳回類型
Set-CsSite 不會傳回任何物件或值。而是指令程式會修改 Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsSite -Identity Redmond -Description "Full-time employees in Redmond, WA."
範例 1 所示的命令會修改 Redmond 站台的 Description 屬性 (-Identity Redmond)。
-------------------------- 範例 2 ------------------------
Set-CsSite -Identity Redmond -DisplayName "US Headquarters"
上述命令會將 Redmond 站台的顯示名稱變更為 "US Headquarters"。
-------------------------- 範例 3 ------------------------
Get-CsSite | Where-Object {$_.Description -eq $Null} | ForEach-Object {Set-CsSite $_.Identity -Description "Litwareinc.com"}
範例 3 所示的命令會找到所有不含 Description 的站台，然後為每個站台指派一般描述 "Litwareinc.com"。為達成此目的，命令會先呼叫 Get-CsSite 但不指定任何參數，以傳回所有 Lync Server 站台的集合。然後將傳回的集合傳送到 Where-Object 指令程式，它只會挑選出 Description 屬性等於 (-eq) null 值 ($Null) 的站台。接著將這些站台傳送到 ForEach-Object 指令程式。此指令程式會取得集合中的每個項目，然後使用 Set-CsSite 來修改 Description 屬性值。