Set-CsWebServiceConfiguration
上次修改主題的時間: 2012-04-23
修改現有的 Web 服務 組態設定集合。
語法
Set-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Set-CsWebServiceConfiguration [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-Instance <PSObject>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
詳細描述
許多 Microsoft Lync Server 2010 元件為 Web 元件:這些元件使用 Web 服務或網頁來執行工作。例如,使用者利用 Web 服務搜尋通訊錄的新連絡人,或使用群組擴充來檢視通訊群組的個別成員。而且,從電話撥入式會議延伸到 Microsoft Lync Server 2010 控制台 都使用網頁作為 Lync Server 2010 和使用者之間的介面。
CsWebServiceConfiguration 指令程式可讓系統管理員管理整個組織的 Web 服務 組態設定。其中包括管理群組擴充、憑證設定以及允許的驗證方法。因為您可以在通用、站台和服務範圍設定不同的設定 (雖然只針對 Web Services 服務),所以可以為不同的使用者和不同的位置自訂 Web 服務 功能。CsWebServiceConfiguration 指令程式 (Get-CsWebServiceConfiguration、New-CsWebServiceConfiguration、Remove-CsWebServiceConfiguration 及 Set-CsWebServiceConfiguration) 可讓系統管理員管理整個組織的 Web 服務組態設定。其中包括管理群組擴充、憑證設定以及允許的驗證方法。您可以在通用、網站及服務範圍 (只針對 Web Services 服務) 設定不同的設定,因此,您可以為不同的使用者和不同的位置自訂 Web 服務 功能。
您可以在建立新的 Web 服務 組態設定集合時,指定自訂設定 (例如憑證的自訂有效期間)。或者,您可以使用 Set-CsWebServiceConfiguration 指令程式修改現有集合的屬性值。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsWebServiceConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsWebServiceConfiguration"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
要修改之 Web 服務 組態設定的唯一識別碼。若要修改在網站範圍設定的設定,請使用類似如下的語法:-Identity "site:Redmond"。若要修改在服務範圍設定的設定,請使用類似如下的語法:-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 若要修改在全域範圍設定的設定,您可以使用下列語法:-identity global。 如果未使用 Identity 參數,則 Set-CsWebServiceConfiguration 將會自動修改通用集合。 |
Instance |
必要 |
WebServiceSettings 物件 |
允許您將物件參照傳遞給 Cmdlet,而不設定個別參數值。 |
AllowAnonymousAccessToLWAConference |
選用 |
布林值 |
設為 True 時,允許匿名使用者參加 Lync Web App (LWA) 會議。 |
CASigningKeyLength |
選用 |
整數 |
設定 CA 簽署金鑰的大小;簽署金鑰是憑證授權單位 (CA) 用來簽署數位憑證的私密金鑰。簽署金鑰的長度可設為 2048 和 16384 個位元組之間的任何整數值;預設值為 2048。 |
DefaultValidityPeriodHours |
選用 |
整數 |
使用憑證驗證時,用戶端可以要求憑證保持有效的時間 (小時)。DefaultValidityPeriodHours 代表用戶端未要求自訂有效期間時,憑證將保持有效的時間。 DefaultValidityPeriodHours 可以是介於 8 小時和 8760 小時 (365 天) 之間的任何整數值。預設值為 4320 (180 天)。 |
EnableCertChainDownload |
選用 |
布林值 |
如果設為 True,擁有驗證憑證的伺服器會下載該憑證的憑證鏈結。憑證鏈結會追蹤個別憑證,一直追溯到發行的 CA。除非憑證的 CA 受到信任,否則驗證將不會接受憑證。 |
EnableGroupExpansion |
選用 |
如果設為 True,則將啟用 Microsoft Lync 2010 中的群組擴充。使用者可以使用群組擴充,將通訊群組設定為連絡人,然後「展開」該群組。群組展開後,使用者就可以看到群組的個別成員及其目前狀態資訊。 |
|
InferCertChainFromSSL |
選用 |
布林值 |
如果設為 True,伺服器會使用安全通訊端層 (SSL) 通訊協定中包含的憑證資訊來判斷簽發的 CA。除非憑證的 CA 受到信任,否則驗證將不會接受憑證。 |
MACResolverUrl |
選用 |
字串 |
能夠執行媒體存取控制 (MAC) 解析的 Web 服務 URL。MAC 解析包含取得一個 IP 位址,然後判斷與該 IP 位址相關聯之網路卡的 MAC 位址。 |
MaxCSRKeySize |
選用 |
整數 |
設定憑證簽署要求 (CSR) 金鑰的大小上限 (CSR 是從申請人傳送至 CA 的訊息,以便申請數位憑證)。可將 CSR 金鑰大小上限設為介於 1024 和 16384 位元組之間的任何整數值。預設值為 16384。 |
MaxGroupSizeToExpand |
選用 |
整數 |
代表展開群組時要顯示之人員的數目上限。例如,如果 MaxGroupSizeToExpand 設為 75,每次展開群組時,只會顯示前 75 個群組成員。 MaxGroupSizeToExpand 可以設為 1 和 1000 (含) 之間的任何整數值。預設值為 100。 |
MaxValidityPeriodHours |
選用 |
整數 |
使用憑證驗證時,用戶端可以要求憑證保持有效的時間 (小時)。MaxValidityPeriodHours 代表用戶端可要求的時間上限。 MaxValidityPeriodHours 可以是介於 8 小時和 8760 小時 (365 天) 之間的任何整數值。預設值為 8760。 |
MinCSRKeySize |
選用 |
整數 |
設定憑證簽署要求 (CSR) 金鑰的大小下限 可將大小下限設為介於 1024 和 16384 位元組之間的任何整數值。預設值為 16384。 |
MinValidityPeriodHours |
選用 |
整數 |
使用憑證驗證時,用戶端可以要求憑證保持有效的時間 (小時)。MinValidityPeriodHours 代表用戶端可要求的時間下限。 MinValidityPeriodHours 可以是介於 8 小時和 4320 小時 (180 天) 之間的任何整數值。預設值為 8。 |
SecondaryLocationSourceUrl |
選用 |
字串 |
可處理位置要求的 Web 服務 URL。只有在本機無法解析位置要求時才會使用此服務。 |
ShowDownloadCommunicatorAttendeeLink |
選用 |
布林值 |
如果設為 True (預設值),使用 Lync 2010 以外之用戶端應用程式加入會議的使用者,將會看到一個指引他們下載 Lync 2010 Attendee 的連結。 |
ShowJoinUsingLegacyClientLink |
選用 |
布林值 |
如果設為 True,可讓使用 Lync 2010 以外之用戶端應用程式加入會議的使用者,有機會使用目前的用戶端應用程式加入會議。預設值為 False。 |
TrustedCACerts |
選用 |
憑證集合 |
受 Web 伺服器信任之憑證鏈結的憑證集合。新增到集合的新憑證必須使用 New-CsWebTrustedCACertificate 指令程式建立。 如果 InferCertChainFromSSL 屬性設為 True,則不會使用此集合。 |
UseCertificateAuth |
選用 |
布林值 |
設為 True (預設值) 時,可使用憑證來驗證用戶端。將此值設為 False 可停用憑證驗證。 |
UsePinAuth |
選用 |
布林值 |
設為 True (預設值) 時,會使用個人識別碼 (PIN) 驗證用戶端。將此值設為 False 可停用 PIN 驗證。 |
UseWindowsAuth |
選用 |
PS 清單修飾詞 |
決定如何 (及是否) 使用 Windows 驗證 (也就是使用與他們登入 Windows 時所使用的相同憑證) 來驗證使用者。有效值為: Negotiate – 用戶端與伺服器會共同運作來決定正確的驗證通訊協定 (Kerberos 或 NTLM)。 NTLM – 將允許使用 Windows 驗證,但只可使用 NTLM 通訊協定。 None – 不允許使用 Windows 驗證。 |
Force |
選用 |
切換參數 |
隱藏當執行 Cmdlet 時可能發生的任何確認提示或非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 物件。Set-CsWebServiceConfiguration 接受管線傳送的 Web 服務設定物件輸入。
傳回類型
Set-CsWebServiceConfiguration 不會傳回值或物件,而指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $True
範例 1 將 Web 服務 組態設定的群組擴充套用至 Redmond 站台 (-Identity site:Redmond)。加入 EnableGroupExpansion 屬性,並將參數值設為 True 可完成這個工作。
-------------------------- 範例 2 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Set-CsWebServiceConfiguration -MaxValidityPeriodHours 16
在範例 2 中,於網站範圍套用之所有 Web 服務 組態設定的有效期間上限會變更為 16 小時。為了執行此工作,呼叫 Get-CsWebServiceConfiguration 時會加上 Filter 參數;篩選值 "site:*" 會將傳回的資料限制為其 Identity 開頭為字元 "site:" 的設定。接著,此集合會傳送到 Set-CsWebServiceConfiguration,取得集合中的每個項目,並將 MaxValidityPeriodHours 屬性變更為 16。
-------------------------- 範例 3 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $True} | Set-CsWebServiceConfiguration -MaxGroupSizeToExpand 400
在以上的命令中,將允許群組擴充之 Web 服務組態設定每個集合的群組擴充大小設定為 400。若要這樣做,呼叫 Get-CsWebServiceConfiguration 但不加上任何參數;這樣會傳回組織中使用之所有 Web 服務 組態設定的集合。接著,此集合會傳送到 Where-Object,只選取 EnableGroupExpansion 屬性等於 True 的設定。然後,這個篩選過的集合會傳送到 Set-CsWebServiceConfiguration,取得集合中的每個項目,並將 MaxGroupSizeToExpand 屬性的值設為 400。
-------------------------- 範例 4 ------------------------
Set-CsWebServiceConfiguration -Identity global -ShowDownloadCommunicatorAttendeeLink $True
範例 4 所示的命令會顯示如何設定通用 Web 服務設定,以便使用 Lync 2010 以外的用戶端應用程式加入會議的使用者先看到一個指引他們下載 Lync 2010 Attendee 的網站連結。加入 ShowDownloadCommunicatorAttendeeLink 參數,並將參數值設為 $True 便可完成這個工作。