Get-CsWebServiceConfiguration
上次修改主題的時間： 2012-03-23
傳回用於組織的所有 Web 服務 組態設定相關資訊。
語法
Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
許多 Microsoft Lync Server 2010 元件為 Web 元件：這些元件使用 Web 服務或網頁來執行工作。例如，使用者利用 Web 服務搜尋通訊錄的新連絡人，或使用群組擴充來檢視通訊群組的個別成員。同樣地，從電話撥入式會議到 Microsoft Lync Server 2010 控制台等元件都是使用網頁作為 Lync Server 2010 和使用者之間的介面。
CsWebServiceConfiguration 指令程式可讓系統管理員管理整個組織的 Web 服務組態設定，包括群組擴充、憑證設定及允許之驗證方法等項目的管理。因為您可以在通用、站台和服務範圍設定不同的設定 (雖然只針對 Web Services 服務)，所以可以為不同的使用者和不同的位置自訂 Web 服務 功能。
Get-CsWebServiceConfiguration 指令程式可讓您傳回目前用於組織的 Web 服務 組態設定詳細資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsWebServiceConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWebServiceConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要傳回之 Web 服務 組態設定的唯一識別碼。若要傳回通用設定，請使用此語法：-Identity global。若要傳回在此站台範圍設定的設定，請使用如下的語法：-Identity "site:Redmond."可使用下列語法傳回 Service-scope 設定：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 您無法在同一個命令中同時使用 Filter 與 Identity 參數。如果您沒有指定其中一個參數，Get-CsWebServiceConfiguration 會傳回目前用於組織的所有 Web 服務 設定集合。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的 Web 服務 組態設定集合時使用萬用字元。例如，此語法會傳回站台範圍設定的所有設定：-Filter "site:*"。 您無法在同一個命令中同時使用 Filter 與 Identity 參數。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取 Web 服務組態資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsWebServiceConfiguration 不會接受管線傳送的輸入。
傳回類型
Get-CsWebServiceConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsWebServiceConfiguration
上述命令會傳回目前用於組織的所有 Web 服務 組態設定資訊。
-------------------------- 範例 2 ------------------------
Get-CsWebServiceConfiguration -Identity site:Redmond
範例 2 所示的命令傳回 Identity 為 site:Redmond 的 Web 服務 組態設定資訊。
-------------------------- 範例 3 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*"
範例 3 傳回站台範圍指派的所有 Web 服務 組態設定。為了執行這項作業，請在呼叫 Get-CsWebServiceConfiguration 時指定 Filter 參數；篩選值 "site:*" 確保只有 Identity 以字串值 "site:" 為開頭的那些設定才會傳回。
-------------------------- 範例 4 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.UsePinAuth -eq $False}
範例 4 的命令會傳回所有不允許個人識別碼 (PIN) 驗證的 Web 服務組態設定。這是由初次呼叫 Get-CsWebServiceConfiguration 以傳回目前使用中的所有 Web 服務 組態設定。此集合會被傳送到 Where-Object 指令程式，這樣只會選出 UsePinAuth 屬性等於 False 的設定。
-------------------------- 範例 5 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}
上述命令傳回群組擴充大小大於 100 的所有 Web 服務 組態設定。為了執行這項作業，命令會先使用 Get-CsWebServiceConfiguration 傳回目前使用中的所有 Web 服務 組態設定。此資訊會被傳送到 Where-Object 指令程式，這樣只選取 MaxGroupSizeToExpand 屬性大於 100 的設定。