Get-CsProxyConfiguration
上次修改主題的時間： 2012-03-23
傳回組織目前所使用之 Proxy 伺服器組態設定的相關資訊。
語法
Get-CsProxyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
Microsoft Lync Server 2010 可讓您經由 Proxy 伺服器組態設定來管理 Proxy 伺服器。這些可同時在全域範圍和服務範圍上套用的設定 (雖然只針對 Edge Server 和登錄器服務)，可讓您控制能夠由用戶端端點使用的驗證通訊協定，以及是否在傳入和傳出的 Proxy 伺服器連線中使用壓縮。安裝 Lync Server 2010 時，會自動為您建立 Proxy 伺服器組態設定的通用集合。如上述，您還可以在服務範圍上建立其他集合。
Get-CsProxyConfiguration 指令程式可讓您傳回目前組織所使用之任何 Proxy 伺服器組態設定的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsProxyConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsProxyConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要傳回之 Proxy 伺服器組態設定的唯一識別碼。若要傳回通用設定，請使用此語法：-Identity global。若要傳回在服務範圍內所做的設定，請使用類似下列的語法：-Identity "service:EdgeServer:atl-cs-001.litwareinc.com"。請注意，在指定 Identity 時無法使用萬用字元。如果您要 (或需要) 使用萬用字元，則請改用 Filter 參數。 如果未包含此參數，Get-CsProxyConfiguration 會傳回目前組織所使用的所有 Proxy 伺服器設定。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的 Proxy 組態設定時，使用萬用字元。例如，此語法會傳回設定於服務範圍的所有設定：-Filter "service:*"。 您無法在同一個命令中同時使用 Filter 與 Identity 參數。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取 Proxy 組態資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsProxyConfiguration 不會接受管線傳送的資料。
傳回類型
Get-CsProxyConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsProxyConfiguration
範例 1 所示的命令會傳回目前您組織中使用之所有 Proxy 組態設定的集合。作法是呼叫 Get-CsProxyConfiguration 且不用任何參數。
-------------------------- 範例 2 --------------------------
Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"
在範例 2 中，會傳回 Identity 為 service:EdgeServer:atl-cs-001.litwareinc.com 之 Proxy 組態設定的相關資訊。由於 Identity 必須是唯一的，因此這個命令絕對不會傳回一個以上的設定集合。
-------------------------- 範例 3 --------------------------
Get-CsProxyConfiguration -Filter "service:*"
上述命令會傳回已在服務範圍設定之所有 Proxy 設定的相關資訊。為達成此目的，命令會呼叫 Get-CsProxyConfiguration 搭配 Filter 參數；篩選值 "service:*" 確保僅有 Identity 是以字串值 "service:" 開頭的設定開頭的設定。
-------------------------- 範例 4 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}
範例 4 會傳回不可將用戶端認證作為驗證機制使用之 Proxy 組態設定的相關資訊。為了執行此作業，命令會先使用 Get-CsProxyConfiguration，傳回目前正在使用的所有 Proxy 組態設定集合。接著將此集合傳送給 Where-Object 指令程式，這樣只會選取 UseCertificateForClientToProxyAuth 屬性等於 False 的設定。
-------------------------- 範例 5 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}
上述命令會傳回用戶端訊息本文的大小上限小於 5000 KB 的所有 Proxy 組態設定。為達成此目的，命令會先呼叫 Get-CsProxyConfiguration 且不用任何參數；這樣會傳回目前正在使用之所有 Proxy 組態設定的集合。接著將此集合傳送給 Where-Object，這樣只會挑出 MaxClientMessageBodySizeKb 屬性小於 5000 KB 的設定。