New-CsPresencePolicy
上次修改主題的時間： 2012-03-25
在站台範圍或個別使用者範圍建立新的目前狀態原則。
語法
New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
詳細描述
目前狀態資訊十分有價值，它可讓您知道連絡人是否可參與立即訊息交談。但同時，使用目前狀態資訊也是有代價的：目前狀態訂閱的愈多，則必須有更多專供更新目前狀態資訊使用的網路頻寬。如果您擔心網路頻寬的問題，可以限制每個人的目前狀態訂閱數。
CsPresencePolicy 指令程式可讓您管理目前狀態資訊兩個重要的層面：已提示訂閱者與類別目錄訂閱。在將您新增到另一個人的 Microsoft Lync 2010 連絡人清單後，為您設定的預設行為是會收到快顯通知來告知已將您新增到該清單中。一直到您將顯示的對話方塊關閉後，每個通知才能算作已提示訂閱者。目前狀態原則的 MaxPromptedSubscriber 屬性可讓您指定使用者可擁有的未解決通知對話方塊數目上限(如果使用者到達上限，就不會再收到新的連絡人通知 - 至少在某些對話方塊已解決前不會)。
類別目錄訂閱代表要求特定的資訊目錄，例如要求行事曆資訊的應用程式。MaxCategorySubscription 屬性可讓您設定使用者可擁有的類別目錄訂閱數限制。
Microsoft Lync Server 2010 之前版本的已提示訂閱者與類別目錄訂閱是通用管理的。透過 CsPresencePolicy 指令程式，您可以在全域範圍、站台範圍，甚至是個別使用者範圍管理這些目前狀態訂閱。這可讓您控制頻寬的使用，同時確保使用者能夠存取工作所需的目前狀態資訊。
New-CsPresencePolicy 指令程式提供一種方法，可讓您在站台範圍或個別使用者範圍建立自訂目前狀態原則。在站台範圍建立的原則會自動套用至該站台；在個別使用者範圍建立的原則就必須藉由執行 Grant-CsPresencePolicy 指令程式來指派給使用者。請注意，您既無法在全域範圍建立新的目前狀態原則，也無法在個別站台建立第二個目前狀態原則 (例如，Redmond 站台只能裝載一個目前狀態原則)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsPresencePolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsPresencePolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
Xds 識別身份 |
新目前狀態原則的唯一識別碼。若要建立新的個別使用者原則，請使用如下的語法：-Identity "RedmondPresencePolicy"。若要在站台範圍建立新的原則，請使用如下的語法：-Identity "site:Redmond"。 請注意，您無法在全域範圍建立新的目前狀態原則。此外，如果有問題的站台已裝載目前狀態原則，或如果您嘗試使用現有個別使用者原則的 Identity，則您的命令也將失敗。 |
|
Description |
選用 |
字串 |
可讓系統管理員提供隨附於目前狀態原則的其他文字。例如，Description 可包含被指派原則的使用者相關資訊。 |
MaxCategorySubscription |
選用 |
整數 |
任何時候可以同時具有的類別訂閱數上限。類別訂閱代表要求取得某類資訊；例如，應用程式要求行事曆資料。 MaxCategorySubscription 可以設為任何介於 0 與 3000 之間的整數值；預設值為 1000。 |
MaxPromptedSubscriber |
選用 |
整數 |
任何時候使用者可以同時具有的升級訂閱者數上限。根據預設，每次您被新增至其他使用者的連絡人清單時，畫面上都會顯示一個通知對話方塊告知您此情況，並提供您將該人員新增至自己的連絡人清單或是封鎖該人員檢視您目前狀態的機會。除非您採取動作並關閉對話方塊，否則每個通知都會算作一個提示的訂閱者。 MaxPromptedSubscriber 可以設為任何介於 0 與 600 (含) 之間的整數值；預設值為 200。如果您將此值設為 0，則使用者將不會在被其他人新增至連絡人清單時收到任何通知。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsPresencePolicy 不會接受管線傳送的輸入。
傳回類型
New-CsPresencePolicy 會建立 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500
範例 1 所示的命令會建立其 Identity 為 RedmondPresencePolicy 的新個別使用者目前狀態原則。在此範例中，MaxPromptedSubscriber 屬性值會設為 400，而 MaxCategorySubscription 屬性值會設為 500。
-------------------------- 範例 2 ------------------------
$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x
在範例 2 中，新的個別使用者目前狀態原則一開始會建立在記憶體中，稍後才會轉換為實際的目前狀態原則。為達成此目的，此範例中的第一個命令會建立 Identity 為 RedmondPresencePolicy 的目前狀態原則，並將此原則儲存於名為 $x 的變數中。InMemory 變數會確保原則只會建立在記憶體中，而不會立即新增至 Lync Server 2010。
命令 2 和命令 3 會接著被用來設定虛擬原則的 MaxPromptedSubscriber 和 MaxCategorySubscription 屬性。在設定原則值之後，第 4 行使用 Set-CsPresencePolicy 和 Instance 參數來根據 $x 中儲存的資訊，建立實際的目前狀態原則。最後這一個步驟很重要：如果您未呼叫 Set-CsPresencePolicy，則原則只會存在記憶體中，只要您結束 Windows PowerShell 工作階段或刪除變數 $x，此原則就會消失不見。