Set-CsNetworkSite
上次修改主題的時間： 2012-03-26
修改現有網站，系統已針對通話許可控制 (CAC) 或增強型 9-1-1 (E9-1-1) 定義了該網站。
語法
Set-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
網站是指在 CAC 或 E9-1-1 部署的每一個區域內設定的辦公室或位置。這個指令程式修改現有網站上的設定。它可以包含網站的關聯地區、網站描述，以及相關的頻寬原則設定檔。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsNetworkSite Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSite"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsGlobalRelativeIdentity |
您要修改之網站的唯一識別碼。只會在全域範圍建立網站，所以您不必指定範圍。但是您必須僅指定網站 ID。 |
Instance |
選用 |
DisplayNetworkSiteType |
網站物件的參考 (類型 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 的物件)。您可以呼叫 Get-CsNetworkSite 指令程式來擷取此物件。 |
BWPolicyProfileID |
選用 |
字串 |
頻寬原則設定檔 (可定義該網站的限制) 的 Identity。您可以呼叫 Get-CsNetworkBandwidthPolicyProfile 指令程式，來擷取可用的設定檔清單。 如果您指定此參數的值，您還必須指定 NetworkRegionID 參數的值。 |
BypassID |
選用 |
字串 |
全域唯一識別碼 (GUID)。這個 GUID 可用來在 CAC 或 E9-1-1組態內部，將網站對應至媒體旁路設定。(對 New-CsNetworkMediaBypassConfiguration 呼叫時使用這個 BypassID 值)。 如果您指定此參數的值，您還必須指定 NetworkRegionID 參數的值。如果您沒有指定此參數的值，但您指定 NetworkRegionID，則會自動產生 BypassID。 如果您明確指定值，則必須是 GUID 格式 (例如，3b24a047-dce6-48b2-9f20-9fbff17ed62a)。建議您提供 NetworkRegionID 的值，並允許自動產生 BypassID 值。如果您手動輸入值，您會收到一個確認提示，確定您不想自動產生值。 |
Description |
選用 |
字串 |
描述網站的字串。可使用這個參數來提供網站適用對象的更多描述性說明，或單獨透過 Identity 表示位置。 |
LocationPolicy |
選用 |
字串 |
與這個網站相關聯的位置原則名稱。位置原則指派特定的 E9-1-1 設定至網站。呼叫 Get-CsLocationPolicy 指令程式可擷取位置原則清單。 |
NetworkRegionID |
選用 |
字串 |
與這個網站相關聯的網路地區 Identity。如果您要提供 BypassID (透過自動產生或手動)，或網路組態的 EnableBandwidthPolicyCheck 屬性設為 True，則此參數必須包含值。您可以透過呼叫 Get-CsNetworkConfiguration 指令程式來擷取網路組態設定。 如果 BypassID 已存在於這個網站上，並且沒有指定 BypassID 參數值，則現有的 BypassID 會被自動產生的 BypassID 覆寫。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 物件。接受管線傳送的網站物件輸入。
傳回類型
這個指令程式不會傳回值。它會修改類型 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
這個範例會修改名為溫哥華的網站。將要修改的網站名稱指定為 Identity 參數的值。將溫哥華網站移動到需要變更 NetworkRegionID 參數的新地區，這個範例是移動到加拿大地區。因為已提供 NetworkRegionID，但沒有為 BypassID 指定值，所以將自動產生 BypassID 值。所有先前存在的旁路識別碼都會被覆寫。
-------------------------- 範例 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
範例 2 簡單修改與溫哥華網站相關聯的頻寬原則設定檔。將網站名稱指定為 Identity 參數的值。然後，指定 BWPolicyProfileID 參數的值：LowBWLimits。與該設定檔相關聯的原則將用於此網站。