New-CsWebServiceConfiguration
上次修改主題的時間： 2012-04-23
建立新的 Web 服務組態設定集合。
語法
New-CsWebServiceConfiguration -Identity <XdsIdentity> [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-InMemory <SwitchParameter>] [-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 服務功能。
新的 Web 服務組態設定是使用 New-CsWebServiceConfiguration 指令程式所建立的。請注意，這些設定只能在網站範圍或服務範圍 (且僅適用於 Web Services 服務) 建立；如果您嘗試在全域範圍建立新集合，則命令會失敗。同樣的，如果您嘗試在網站範圍建立新的集合，例如在 Redmond 網站，而該網站已託管 Web 服務設定的集合，則命令會失敗。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsWebServiceConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsWebServiceConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別 |
要建立之 Web 服務組態設定的唯一識別碼。若要建立在此網站範圍完成的設定，請使用如下的語法：-Identity "site:Redmond"。若要建立在此服務範圍設定的設定，請使用如下的語法：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。請注意，在服務範圍建立的任何設定必須指派給 Web 伺服器服務。 |
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 的訊息)。可將大小上限設為介於 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 |
選用 |
Certificate 集合 |
受 Web 伺服器信任之憑證鏈結的憑證集合。新增到集合的新憑證必須使用 New-CsWebTrustedCACertificate 指令程式建立。 如果 InferCertChainFromSSL 屬性設為 True，則不會使用此集合。 |
UseCertificateAuth |
選用 |
布林值 |
設為 True (預設值) 時，會使用憑證驗證用戶端。將此值設為 False ($False) 可停用憑證驗證。 |
UsePinAuth |
選用 |
布林值 |
設為 True (預設值) 時，會使用個人識別碼 (PIN) 驗證用戶端。將此值設為 False ($False) 可停用 PIN 驗證。 |
UseWindowsAuth |
選用 |
PS 清單修飾詞 |
決定如何 (以及是否) 使用 Windows 驗證來驗證使用者；亦即使用當使用者登入 Windows 時所使用的相同認證進行驗證。有效值為： Negotiate - 用戶端與伺服器會共同運作，以決定適當的驗證通訊協定 (Kerberos 或 NTLM)。 NTLM – 允許 Windows 驗證，但僅使用 NTLM 通訊協定。 None – 不允許 Windows 驗證。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsWebServiceConfiguration 不會接受管線傳送的輸入。
傳回類型
New-CsWebServiceConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $False -UseCertificateAuth $True
範例 1 所示的命令會為 Redmond 網站 (-Identity site:Redmond) 建立新的 Web 服務組態設定集合。此範例包含兩個選擇性參數：一是 EnableGroupExpansion，此參數會設為 False ($False)；而另一個則是 UseCertificateAuth，此參數會設為 True ($True)。這兩個參數分別用於停用群組擴充，以及讓憑證能夠用於驗證。
請注意，如果已經建立用於 Redmond 網站的 Web 服務組態設定集合，則此命令會失敗。這是因為網站只能有一個 Web 服務組態設定集合的限制。
-------------------------- 範例 2 ------------------------
$x = New-CsWebServiceConfiguration -Identity site:Redmond -InMemory
$x.EnableGroupExpansion = $False
$x.UseCertificateAuth = $True
Set-CsWebServiceConfiguration -Instance $x
範例 2 是範例 1 命令的變化；在此例中，新的 Web 服務組態設定集合一開始只會在記憶體中建立，只有在日後才會套用到 Redmond 網站。為了執行此作業，範例的第一個命令會使用 New-CsWebServiceConfiguration 建立 Redmond 網站的設定集合，並包含 InMemory 參數以確定此集合只會建立在記憶體中，不會立即套用到 Redmond 網站(因為設定只存在於記憶體中，所以必須儲存在變數內，在此例中即名為 $x 的變數)。
範例中的命令 2 與命令 3 會取得這些虛擬組態設定，並修改 EnableGroupExpansion 和 UseCertificateAuth 內容的值。在進行這些變更後，最後一個命令會使用 Set-CsWebServiceConfiguration 取得虛擬設定，並將這些設定套用到 Redmond 網站。如果您沒有呼叫 Set-CsWebServiceConfiguration，則不會將任何新的設定指派給網站。而只要您終止 Windows PowerShell 工作階段或刪除變數 $x，虛擬的 Web 服務組態設定隨即會消失。