Remove-CsUserServicesConfiguration
上次修改主題的時間: 2012-03-27
移除現有的使用者服務組態設定集合。使用者服務用於協助維護目前狀態資訊及管理會議。
語法
Remove-CsUserServicesConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 依賴使用者服務協助維護使用者的目前狀態資訊,以及管理會議。CsUserServicesConfiguration 指令程式依序用於管理通用、站台和服務範圍的使用者服務設定 (請注意,可主控使用者服務組態設定的唯一服務為使用者服務服務本身)。這些設定有助於決定使用者可擁有的連絡人數目、使用者可在任何一個時間中排程的會議數,以及所指定的會議可保持為作用中的時間長度等作業。
Remove-CsUserServicesConfiguration 指令程式可讓您刪除已在站台或服務範圍套用的使用者服務組態設定。也可以針對通用集合執行此指令程式。不過,在該情況下,將不會刪除通用設定;因為您無法刪除通用設定,而是將通用集合中的所有屬性重設為其預設值。例如,如果您已將通用設定中的 MaxContacts 值變更為 500,然後執行 Remove-CsUserServciesConfiguration,則 MaxContacts 將會重設為預設值 250。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsUserServicesConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色),請在 Windows PowerShell 提示中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUserServicesConfiguration"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
要移除之使用者服務組態設定的唯一識別碼。若要移除在網站範圍設定的設定,請使用類似如下的語法:-Identity site:Redmond。若要刪除服務層級的設定,請使用類似如下的語法:-Identity service:UserServer:atl-cs-001.litwareinc.com。 您也可以針對通用集合執行 Remove-CsUserServicesConfiguration。不過,在該情況下,將不會刪除通用集合,而是將該集合中的所有屬性重設為其預設值。 |
Force |
選用 |
切換參數 |
抑制顯示執行命令時可能引起的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 物件。Remove-CsUserServicesConfiguration 接受管線傳送的使用者服務設定物件執行個體。
傳回類型
無。而 Remove-CsUserServicesConfiguration 會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsUserServicesConfiguration -Identity site:Redmond
範例 1 所示的命令會移除 Redmond 站台的使用者服務組態設定 (-identity site:Redmond)。
-------------------------- 範例 2 ------------------------
Get-CsUserServicesConfiguration -Filter "service:*:" | Remove-CsUserServicesConfiguration
在範例 2 中,會刪除已在服務範圍套用的所有使用者服務組態設定。為此,該命令會呼叫 Get-CsUserServicesConfiguration 搭配 Filter 參數。篩選值 "service:*" 會將傳回的資料限制為在服務範圍內進行的設定 (亦即,Identity 開頭字元為 "service:" 的設定)。接著,這個篩選過的集合會傳送到 Remove-CsUserServicesConfiguration,以刪除集合中的每個項目。
-------------------------- 範例 3 ------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration
以上的命令會移除允許使用者擁有超過 250 個連絡人的所有使用者服務組態設定。若要執行此工作,此命令會先呼叫 Get-CsUserServicesConfiguration 且不搭配任何參數,以傳回目前使用中之所有使用者服務組態設定的集合。此集合會傳送到 Where-Object 指令程式,只選取 MaxContacts 屬性大於 250 的設定。接著,那些設定會傳送到 Remove-CsUserServicesConfiguration 指令程式加以移除。