New-CsProxyConfiguration
上次修改主題的時間： 2012-03-26
建立新的 Proxy 組態設定集合。
語法
New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 可讓您經由 Proxy 伺服器組態設定來管理 Proxy 伺服器。這些可同時在全域範圍和服務範圍上套用的設定 (雖然只針對 Edge Server 和登錄器服務)，可讓您控制能夠由用戶端端點使用的驗證通訊協定，以及是否在傳入和傳出的 Proxy 伺服器連線中使用壓縮。安裝 Lync Server 2010 時，會自動為您建立 Proxy 伺服器組態設定的通用集合。如上述，您還可以在服務範圍上建立其他集合。這些新集合可以使用 New-CsProxyConfiguration 指令程式來建立。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsProxyConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsProxyConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別 |
要建立之 Proxy 伺服器組態設定的唯一識別碼。Proxy 伺服器組態設定只能建立在服務範圍上，並只適用於 Edge Server 和登錄器服務。您無法在全域範圍上建立設定；同樣地，如果在該服務已託管一個 Proxy 伺服器設定的集合，則您無法在服務範圍上建立設定。例如，如果 Registrar:atl-cs-001.litwareinc.com 服務已主控一個 Proxy 伺服器設定，任何嘗試為該服務建立新設定的命令都會失敗。 若要指定新 Proxy 伺服器設定的 Identity，請使用如下語法：-Identity "service:Registrar:atl-cs-001.litwareinc.com"。 |
AcceptClientCompression |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會接受所有從用戶端端點傳入的壓縮要求。 |
AcceptServerCompression |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會接受所有從其他伺服器傳入的壓縮要求。 |
DNSCacheRecordCount |
選用 |
整數 |
DNS 記錄快取中可保留的記錄數目上限。預設值是 30000。 |
DisableNTLMFor2010AndLaterClients |
選用 |
布林值 |
設為 True 時，使用者從 Microsoft Lync 2010 登入必須使用 Kerberos 通訊協定進行驗證。預設值為 False。 |
EnableWhiteSpaceKeepAlive |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會預期用戶端定期傳送「空白字元」訊息 (沒有內容的空訊息) 來表示其連線依然在作用中。 |
MaxClientCompressionCount |
選用 |
整數 |
指出在任何指定時間可壓縮之用戶端至伺服器的連線數目上限；超過此限制的其他連線不會被壓縮。可將壓縮計數設為介於 0 (含) 和 65535 (含) 之間的任何整數值。預設值為 15000。 |
MaxClientMessageBodySizeKB |
選用 |
整數 |
從用戶端端點傳送的訊息本文所允許的大小上限 (單位為 KB)。預設值為 128，表示大於 128 KB 的訊息本文會被拒絕。可將用戶端訊息本文大小設為介於 64 (含) 和 256 (含) 之間的任何整數值。 |
MaxServerCompressionCount |
選用 |
整數 |
指出在任何指定時間可壓縮之伺服器至伺服器的連線數目上限；超過此限制的其他連線不會被壓縮。可將伺服器壓縮計數設為介於 0 (含) 和 65535 (含) 之間的任何整數值。預設值為 1024。 |
MaxServerMessageBodySizeKB |
選用 |
整數 |
從其他伺服器傳送的訊息本文所允許的大小上限 (KB)。預設值為 5000，表示大於 5000 KB 的訊息本文會被拒絕。可將伺服器訊息本文大小設為介於 1000 (含) 和 20000 (含) 之間的任何整數值。 |
OutgoingTLSCount |
選用 |
整數 |
指定可用於每個內部伺服器的傳輸層安全性 (TLS) 連線數量上限。TLS 連線數目下限為 1，上限為 4。依據預設，OutgoingTlsCount 設為 4。 |
Realm |
選用 |
SipProxy 物件 |
指出是否由預設的 Proxy 伺服器領域 (SIP Communications Service) 或由自訂領域處理安全性認證。必須使用 New-CsSipProxyCustom 指令程式來指定 (和建立) 自訂領域。 |
RequestServerCompression |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會要求在所有連至伺服器的傳出連線上必須使用壓縮。 |
TreatAllClientsAsRemote |
選用 |
布林值 |
設為 True 時，Proxy 伺服器的運作會好像所有用戶端連線為透過執行 Access Edge Service 的 Edge Server 傳遞之外部連線一樣。預設值為 False。 |
UseCertificateForClientToProxyAuth |
選用 |
布林值 |
設為 True (預設值) 時，用戶端端點可以使用憑證進行驗證。 |
UseKerberosForClientToProxyAuth |
選用 |
布林值 |
設為 True (預設值) 時，用戶端端點可以使用 Kerberos 通訊協定進行驗證。雖然 Kerberos 的安全性高於 NTLM 通訊協定，但如果用戶端與伺服器分屬於不同網域，它便無法使用。 |
UseNtlmForClientToProxyAuth |
選用 |
布林值 |
設為 True (預設值) 時，用戶端端點可以使用 NTLM 通訊協定進行驗證。雖然 NTLM 的安全性低於 Kerberos 通訊協定，但如果用戶端與伺服器分屬於不同網域，它還是可以使用。這種情況不適用於 Kerberos 驗證。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsProxyConfiguration 不會接受管線傳送的輸入。
傳回類型
New-CsProxyConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 物件的新執行個體。
範例
-------------------------- 範例 1 --------------------------
New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256
上述命令會建立 EdgeServer:atl-edge-001.litwareinc.com 服務之 Proxy 組態設定的新集合。除下列兩項外，這些新設定會使用所有預設的 Proxy 伺服器屬性值：RequestServerCompression 設為 True；MaxClientMessageBodySizeKb 設為 256。請注意，如果已經為 EdgeServer:atl-edge-001.litwareinc.com 服務設定 Proxy 伺服器設定，此命令會失敗。
-------------------------- 範例 2 --------------------------
$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x
範例 2 所示的命令示範如何建立最初只存在於記憶體內的 Proxy 伺服器設定集合。如果要執行這項作業，命令會先呼叫 New-CsProxyConfiguration 和兩個參數：Identity (指定設定的 Identity) 和 InMemory，該參數指出新設定只能建立在記憶體中產生的物件儲存在變數 $x 中。
建立這些虛擬設定後，命令 2 和 3 會分別用來修改 RequestServerCompression 和 MaxClientMessageBodySizeKb 屬性的值。最後，命令 4 用來將虛擬 Proxy 伺服器組態設定轉換為套用到 service EdgeServer:atl-edge-001.litwareinc.com 服務的實際設定集合。最後一個命令是必要項目。如果您沒有呼叫 Set-CsProxyConfiguration，則設定不會套用到 EdgeServer:atl-edge-001.litwareinc.com，並在您結束 Windows PowerShell 工作階段或刪除變數 $x 時，虛擬設定會消失。