Set-CsUserServicesConfiguration
上次修改主題的時間： 2012-04-23
修改使用者服務組態設定的現有集合。使用者服務用於協助維護目前狀態資訊及管理會議。
語法
Set-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-CsUserServicesConfiguration [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 依賴使用者服務協助維護使用者的目前狀態資訊，以及管理會議。CsUserServicesConfiguration 指令程式依序用於管理通用、站台和服務範圍的使用者服務設定 (請注意，可主控使用者服務組態設定的唯一服務為使用者服務服務本身)。這些設定有助於決定使用者可擁有的連絡人數目、使用者可在任何一個時間中排程的會議數，以及所指定的會議可保持為作用中的時間長度等作業。
The Set-CsUserServicesConfiguration 指令程式為系統管理員提供了一種方式，來修改目前使用中之任何 (或所有) 使用者服務組態設定的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsUserServicesConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserServicesConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要修改之使用者服務組態設定的唯一識別碼。若要修改通用設定，請使用此語法：-Identity global。若要修改在網站範圍設定的設定，請使用類似如下的語法：-Identity site:Redmond。若要修改服務層級的設定，請使用類似如下的語法：-Identity service:UserServer:atl-cs-001.litwareinc.com。 |
Instance |
選用 |
UserServicesSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
AnonymousUserGracePeriod |
選用 |
時間範圍 |
表示在會議中尚未加入已驗證使用者的情況下，匿名 (未驗證的) 使用者可以待在同一會議中的時間長度。例如，如果將這個值設為 15 分鐘，在已驗證的使用者必須加入前，匿名使用者最多可留在會議中 15 分鐘。如果在這段寬限期結束前沒有已驗證的使用者加入，則必須將匿名使用者從會議中移除。此設定同時適用於排程會議及在 Microsoft Lync 中按一下 [立即開會] 所建立的臨時會議。 您必須使用下列格式指定 AnonymousUserGracePeriod：days.minutes:seconds (例如 0.00:30:00 表示 30 分鐘)。寬限期可設為介於 0 秒與 1 天之間的任何值，預設值為 90 分鐘 (01:30:00)。 |
DeactivationGracePeriod |
選用 |
時間範圍 |
會議可維持作用中的時間長度上限。您必須使用下列格式指定這個值：days.hours:minutes:seconds.例如，若要讓會議持續 60 小時，您可以使用此格式：2.12:00:00 (2 天：12 小時：00 分鐘：00 秒。) DeactivationGracePeriod 必須介於 8 小時和 365 天 (含) 之間。預設值是 1 天。 |
DefaultSubscriptionExpiration |
選用 |
整數 |
每次使用者要求目前狀態資訊之類的資料時，就會建立訂閱。要求提出時，使用者 (或更正確地說，使用者的用戶端應用程式) 可以要求訂閱在必須更新前可維持有效的時間長度。如果未發出此類要求，則訂閱會設為由 DefaultSubscriptionExpiration 屬性指定的值。 預設訂閱時間必須以介於 300 秒 (5 分鐘) 與 86400 秒 (24 小時) (含) 之間的整數值來表示。預設值為 28800 秒 (8 小時)。 |
MaintenanceTimeOfDay |
選用 |
日期時間 |
表示一天內定期排程之資料庫維護 (例如清除過時記錄) 進行的時間。這個值必須指定為日期時間值；可以使用 24 小時制 (例如 "14:00") 或 12 小時制 (例如 "2:00 PM")。 MaintenanceTimeOfDay 的預設值為 1:00 AM (01:00:00)。 |
MaxContacts |
選用 |
整數 |
使用者可擁有的連絡人數目上限；預設值為 250。MaxContacts 屬性代表使用者可擁有之連絡人的絕對數目上限。不過，您可使用 CsClientPolicy 指令程式限制特定使用者的連絡人數目上限，使其低於 MaxContacts 的值。 |
MaxPersonalNotes |
選用 |
整數 |
表示儲存在使用者之記事歷程記錄中的個人記事數目上限。依預設，最後 3 筆個人記事會保留在記事歷程記錄中。可保留在歷程記錄中之記事數目上限為 10。 |
MaxScheduledMeetingsPerOrganizer |
選用 |
整數 |
指定時間內單一使用者可做為召集人之會議的數目上限。預設值為 1000；也就是說，如果使用者已是 1000 場會議的召集人，其排程新會議 (會議編號 1001) 的要求將會失敗。 |
MaxSubscriptionExpiration |
選用 |
整數 |
每次使用者要求目前狀態資訊之類的資料時，就會建立訂閱。要求提出時，使用者 (或更正確地說，使用者的用戶端應用程式) 可以要求訂閱在必須更新前可維持有效的時間長度。MaxSubscriptionExpiration 屬性代表可授與用戶端的時間長度上限。例如，如果時間上限設為 28800 秒，而用戶端要求的逾時間隔為 86400 秒，則用戶端會獲得下列允許的到期時間上限：28800 秒。 訂閱時間上限必須以介於 300 秒 (5 分鐘) 與 86400 秒 (24 小時) (含) 之間的整數值來表示。預設值為 43200 秒 (12 小時)。 |
MaxSubscriptions |
選用 |
整數 |
任一時間內使用者可開啟之 SIP 訂閱對話方塊的數目上限。訂閱對話方塊代表 SIP 資源的要求。 |
MinSubscriptionExpiration |
選用 |
整數 |
每次使用者要求目前狀態資訊之類的資料時，就會建立訂閱。要求提出時，使用者 (或更正確地說，使用者的用戶端應用程式) 可以要求訂閱在必須更新前可維持有效的時間長度。MinSubscriptionExpiration 屬性代表可授與用戶端的時間長度下限。例如，如果時間下限設為 1200 秒，而用戶端要求的逾時間隔為 200 秒，則用戶端將獲得下列允許的到期時間下限：1200 秒。 訂閱時間下限必須以介於 300 秒 (5 分鐘) 與 86400 秒 (24 小時) (含) 之間的整數值來表示。預設值為 1200 秒 (20 分鐘)。 |
SubscribeToCollapsedDG |
選用 |
布林值 |
如果設為 True (預設值)，即允許用戶端應用程式訂閱目前在連絡人清單中未展開的通訊群組。如此一來用戶端能夠保有群組中每一個成員最即時的目前狀態資訊。如果設為 False，用戶端應用程式將無法訂閱「摺疊的」群組。 |
Force |
選用 |
切換參數 |
抑制顯示執行命令時可能引起的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 物件。Set-CsUserServicesConfiguration 會接受使用者服務設定物件的管線執行個體。
傳回類型
Set-CsUserServicesConfiguration 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsUserServicesConfiguration -Identity site:Redmond -AnonymousUserGracePeriod "00:30:00"
範例 1 所示的命令會修改 Redmond 站台的使用者服務組態設定 (-identity site:Redmond)。在此範例中，AnonymousUserGracePeriod 設為 30 分鐘 (00 小時：30 分鐘：00 秒) 的 A/V Edge 組態設定。
-------------------------- 範例 2 --------------------------
Set-CsUserServicesConfiguration -Identity site:Redmond -MaintenanceTimeOfDay "13:30"
在範例 2 中會修改套用至 Redmond 網站之使用者服務組態設定的 MaintenanceTimeOfDay 屬性。使用 MaintenanceTimeOfDay 參數與參數值 13:30 可完成這個工作。這樣會將一天的維護時間設為 1:30 PM (24 小時制的 13 時 30 分)。
-------------------------- 範例 3 --------------------------
Get-CsUserServicesConfiguration -Filter "service:*" | Set-CsUserServicesConfiguration -MaxContacts 300
以上的命令會擷取在服務範圍套用的所有使用者服務組態設定，然後針對這些項目中的每一個，修改允許的連絡人數目。若要完成此工作，此命令會先使用 Get-CsUserServicesConfiguration 及 Filter 參數擷取服務範圍中設定的所有設定；篩選值 "service:*" 會將傳回的資料限制為 Identity 開頭字元為 "service:" 的設定。接著，這個篩選過的集合會傳送到 Set-CsUserServicesConfiguration，這會取得集合中的每一個項目，並將 MaxContacts 屬性設為 300。
-------------------------- 範例 4 --------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 300} | Set-CsUserServicesConfiguration -MaxContacts 300
在範例 4 中，會修改允許使用者擁有的連絡人數目超過 300 個的所有使用者服務組態設定；修改完成後，就不允許設定超過 300 個連絡人。為達成此目的，此命令會先呼叫 Get-CsUserServicesConfiguration，但不包含任何額外的參數。這樣會傳回組織目前使用中之所有使用者服務組態設定的集合。接著，此集合會傳送到 Where-Object 指令程式，該指令程式只會挑出 MaxContacts 屬性大於 300 的設定。然後，篩選過的集合會傳送到 Set-CsUserServicesConfiguration，取得已篩選之集合中的每個項目，並將允許之連絡人的數目上限變更為 300。