New-CsUserServicesConfiguration
上次修改主題的時間： 2012-04-23
建立新的使用者服務組態設定集合。使用者服務用於協助維護目前狀態資訊及管理會議。
語法
New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 依賴使用者服務協助維護使用者的目前狀態資訊，以及管理會議。CsUserServicesConfiguration 指令程式依序用於管理通用、網站和服務範圍的使用者服務設定 (請注意，可主控使用者服務組態設定的唯一服務為使用者服務服務本身)。這些設定有助於決定使用者可擁有的連絡人數目、使用者可在任何一個時間中排程的會議數，以及所指定的會議可保持為作用中的時間長度等作業。
New-CsUserServicesConfiguration 指令程式提供一種方式給系統管理員，可以在網站或服務範圍建立新的「使用者服務」組態設定集合。(不可在全域範圍建立新集合)。請注意，任何特定網站或服務最多只能有一個「使用者服務」組態設定集合。舉例來說，如果您嘗試為 Redmond 網站建立設定，而這個網站已經裝載「使用者服務」組態設定集合，您的命令就會失敗。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsUserServicesConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中輸入下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUserServicesConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別 |
要建立的「使用者服務」組態設定的唯一識別碼。若要在網站範圍建立設定，請使用類似這樣的語法：-Identity site:Redmond。若要在服務層級建立設定，請使用如下的語法：-Identity service:UserServer:atl-cs-001.litwareinc.com。 |
AnonymousUserGracePeriod |
選用 |
TimeSpan |
表示在會議中尚未加入已驗證使用者的情況下，匿名 (未驗證的) 使用者可以待在同一會議中的時間長度。例如，如果將這個值設為 15 分鐘，在已驗證的使用者必須加入前，匿名使用者最多可留在會議中 15 分鐘。如果在這段寬限期結束前沒有已驗證的使用者加入，則必須將匿名使用者從會議中移除。此設定同時適用於排程會議及在 Microsoft Lync 中按一下 [立即開會] 所建立的臨時會議。 AnonymousUserGracePeriod 必須使用以下格式：days.hours:minutes:seconds (例如 0.00:30:00 表示 30 分鐘)。寬限期必須設為介於 0 秒和 1 天之間的任何值，預設值是 90 分鐘 (01:30:00)。 |
DeactivationGracePeriod |
選用 |
TimeSpan |
會議可持續使用的時間長度上限。這個值必須使用以下格式：days.hours:minutes:seconds。例如，若要使會議持續 60 小時，要使用此格式：2.12:00:00 (2 天. 12 小時: 00 分鐘: 00 秒。) DeactivationGracePeriod 必須介於 8 小時 (含) 和 365 天 (含) 之間。預設值為 1 天 (1.00:00:00)。 |
DefaultSubscriptionExpiration |
選用 |
整數 |
任何時候，只要使用者要求資料，如目前狀態資訊，就會建立訂閱。在建立要求時，使用者 (或者更正確的說，是使用者的用戶端應用程式) 可以要求此訂閱在必須續訂之前，保持有效的時間長度。如果沒有發出這類要求，則會將訂閱設為 DefaultSubscriptionExpiration 屬性所指定的值。 預設訂閱時間必須以介於 300 秒 (5 分鐘) 與 86400 秒 (24 小時) (含) 之間的整數值來表示。預設值是 28800 秒 (8 小時)。 |
MaintenanceTimeOfDay |
選用 |
DateTime |
指定定期資料庫維護 (如清除過時的記錄) 該發生在一天當中的什麼時候。這個值必須指定為日期時間值。您可以使用 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 資源的要求。預設值為 200。 |
MinSubscriptionExpiration |
選用 |
整數 |
任何時候，只要使用者要求資料，如目前狀態資訊，就會建立訂閱。在建立要求時，使用者 (或者更正確的說，是使用者的用戶端應用程式) 可以要求此訂閱在必須續訂之前，保持有效的時間長度。MinSubscriptionExpiration 屬性表示可授與用戶端的時間長度下限。例如，如果時間下限設為 1200 秒，而用戶端要求 200 秒的逾時間隔，則用戶端將獲得最低允許的到期時間：1200 秒。 訂閱時間下限必須以介於 300 秒 (5 分鐘) 與 86400 秒 (24 小時) (含) 之間的整數值來表示。預設值是 1200 秒 (20 分鐘)。 |
SubscribeToCollapsedDG |
選用 |
布林值 |
如果設為 True (預設值)，即允許用戶端應用程式訂閱目前在連絡人清單中未展開的通訊群組。如此一來用戶端能夠保有群組中每一個成員最即時的目前狀態資訊。如果設為 False，用戶端應用程式將不能夠訂閱「摺疊」的群組。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsUserServicesConfiguration 不會接受管線傳送的輸入。
傳回類型
New-CsUserServicesConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"
範例 1 所示的命令會為 Redmond 網站 (-Identity site:Redmond) 建立新的「使用者服務」組態設定集合。除了指定 Identity 外，這個命令也會設定連絡人數目上限 (-MaxContacts 500) 以及維護發生於一天中的什麼時間 (-MaintenanceTimeOfDay "11:00 PM")。請注意，如果 Redmond 網站的「使用者服務」設定已經完成，這個命令就會失敗。這是因為您有每個網站一個設定集合的限制。
-------------------------- 範例 2 ------------------------
$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x
範例 2 也會為 Redmond 網站建立新的使用者服務組態設定集合。但在此範例中，集合一開始只在記憶體中建立，且之後只會套用至 Redmond 網站。為達成此目的，範例中的第一個命令會使用 New-CsUserServicesConfiguration 搭配 InMemory 參數，建立只存在於記憶體中的新集合 (Identity 為 site:Redmond)。因為這個集合只存在記憶體中，所以使用者服務物件必須存在變數中。在此例中，這是名稱為 $x 的變數。
建立虛擬集合後，使用命令 2 和 3 修改 MaxContacts 和 MaintenanceTimeOfDay 屬性的值。然後，範例中的最後一個命令使用 Set-CsUserServicesConfiguration 將這些虛擬設定轉換為實際的使用者服務組態設定集合，套用到 Redmond 網站。最後這一個步驟很重要：如果沒有呼叫 Set-CsUserServicesConfiguration，就不會將任何設定套用到 Redmond 網站，那麼只要您一終止您的 Windows PowerShell 工作階段或刪除變數 $x，您的虛擬設定便會消失。