Set-CsProxyConfiguration
上次修改主題的時間： 2012-03-27
修改現有的 Proxy 伺服器組態設定集合。
語法
Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <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>]]
Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 伺服器組態設定的通用集合。如上述，您還可以在服務範圍上建立其他集合。
Set-CsProxyConfiguration 指令程式提供一種方式，讓您修改 Proxy 伺服器組態設定之現有集合的屬性值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsProxyConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsProxyConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
要修改之 Proxy 伺服器組態設定的唯一識別碼。若要修改通用設定，請使用此語法：-Identity global。若要修改在服務範圍設定的設定，請使用類似如下的語法：-Identity "service:EdgeServer:atl-edge-001.litwareinc.com"。 如果未加入此參數，則 Set-CsProxyConfiguration 將會自動修改通用設定。 |
Instance |
選用 |
ProxySettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
AcceptClientCompression |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會接受來自用戶端端點的所有傳入壓縮要求。 |
AcceptServerCompression |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會接受來自其他伺服器的所有傳入壓縮要求。 |
DisableNTLMFor2010AndLaterClients |
選用 |
布林值 |
設為 True 時，從 Microsoft Lync 2010 登入的使用者必須使用 Kerberos 通訊協定進行驗證。預設值為 False。 |
DNSCacheRecordCount |
選用 |
整數 |
DNS 記錄快取中可保留的記錄數目上限。預設值是 30000。 |
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 通訊服務) 或由自訂領域處理。自訂領域必須使用 New-CsSipProxyCustom 指令程式指定 (或建立)。 |
RequestServerCompression |
選用 |
布林值 |
設為 True (預設值) 時，Proxy 伺服器會要求連到其他伺服器的所有傳出連線都使用壓縮。 |
TreatAllClientsAsRemote |
選用 |
布林值 |
設為 True 時，Proxy 伺服器的運作會好像所有用戶端連線為透過 Edge Server 傳遞之外部連線一樣。預設值為 False。 |
UseCertificateForClientToProxyAuth |
選用 |
布林值 |
設為 True (預設值) 時，用戶端端點可以使用憑證進行驗證。 |
UseKerberosForClientToProxyAuth |
選用 |
布林值 |
設為 True (預設值) 時，用戶端端點可以使用 Kerberos 通訊協定進行驗證。雖然 Kerberos 是比 NTLM 更安全的通訊協定，但是如果用戶端與伺服器屬於不同的網域，則無法使用。 |
UseNtlmForClientToProxyAuth |
選用 |
布林值 |
設為 True (預設值) 時，用戶端端點可以使用 NTLM 通訊協定進行驗證。雖然 NTLM 是比 Kerberos 不安全的通訊協定，但是如果用戶端與伺服器屬於不同的網域，還是可以使用 NTLM。Kerberos 驗證則不是如此。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 物件。Set-CsProxyConfiguration 接受管線傳送的 Proxy 設定物件執行個體。
傳回類型
Set-CsProxyConfiguration 不會傳回值或物件，而是由指令程式設定 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True
在範例 1 中，會修改 Identity 為 service:EdgeServer:atl-edge-001.litwareinc.com 的 Proxy 組態設定，以接受伺服器壓縮。這可以透過呼叫 Set-CsProxyConfiguration 搭配 AcceptServerCompression 參數，以及將參數值設為 True 來完成。
-------------------------- 範例 2 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True
以上的命令會找出接受伺服器壓縮的所有 Proxy 組態設定，然後將這些設定修改為也接受用戶端壓縮。若要這樣做，此命令會先呼叫沒有任何參數的 Get-CsProxyConfiguration，以傳回組織中使用中之所有 Proxy 設定的集合。接著，此集合會傳送到 Where-Object 指令程式，只挑出其 AcceptServerCompression 屬性等於 True 的設定。然後，這個篩選過的集合會傳送到 Set-CsProxyConfiguration，以取得集合中的每個項目，並將 AcceptClientCompression 屬性設為 True。
-------------------------- 範例 3 --------------------------
Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False
範例 3 會示範如何修改已在服務範圍設定的所有 Proxy 設定。若要這樣做，此命令會先呼叫 Get-CsProxyConfiguration 並加入 Filter 參數；篩選值 "service:*" 會確保只傳回具有開頭為字串值 "service:" 之 Identity 的設定。然後，這個篩選過的集合會傳送到 Set-CsProxyConfiguration，以取得集合中的每個項目，並將 UseNtlmForClientToProxyAuth 屬性設為 False。