Set-CsPresencePolicy
上次修改主題的時間： 2012-03-25
修改現有的目前狀態原則。
語法
Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
詳細描述
目前狀態資訊 (除此之外，可讓您知道連絡人是否可以參與立即訊息交談) 非常實用。不過，同時也有與目前狀態資訊相關聯的成本：您擁有的目前狀態訂閱越多，更新目前狀態資訊佔用的網路頻寬就越大。如果網路頻寬是一項顧慮，您可能會想要限制任一個使用者可以擁有的目前狀態訂閱數目。
CsPresencePolicy 指令程式可讓您管理目前狀態訂閱的兩個重要層面：已提示的訂閱者和類別目錄訂閱。在將您新增到另一個人的 Microsoft Lync 2010 連絡人清單後，為您設定的預設行為是會收到快顯通知來告知已將您新增到該清單中。一直到您將顯示的對話方塊關閉後，每個通知才能算作已提示訂閱者。目前狀態原則的 MaxPromptedSubscriber 屬性可讓您指定使用者可以擁有的未決通知對話方塊數目上限 (如果使用者達到數量上限，就不會收到新的連絡人通知 (至少在某些對話方塊解決之前))。
類別目錄訂閱代表對特定資訊類別目錄的要求，例如要求行事曆資料的應用程式。MaxCategorySubscription 屬性可讓系統管理員在使用者可以擁有的類別目錄訂閱上加上限制。
Microsoft Lync Server 2010 之前版本的已提示訂閱者與類別目錄訂閱是通用管理的。透過 CsPresencePolicy 指令程式，您現在可以在全域範圍、站台範圍，甚至是個別使用者範圍管理目前狀態訂閱。這可讓您控制頻寬的使用，同時確保使用者能夠存取執行工作所需的目前狀態資訊。
Set-CsPresencePolicy 指令程式可讓您修改設定為在組織中使用的任何目前狀態原則。修改目前狀態原則僅表示變更 MaxPromptedSubscriber 屬性和/或 MaxCategorySubscription 屬性的值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsPresencePolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsMonitoringServer"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
要修改之目前狀態原則的唯一識別碼。若要修改通用原則，請使用此語法：-Identity global。若要修改網站範圍的原則，請使用類似如下的語法：-Identity "site:Redmond"。若要修改個別使用者原則，請使用類似如下的語法：-Identity "RedmondPresencePolicy"。 |
|
Instance |
選用 |
顯示狀態原則物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
Description |
選用 |
字串 |
可讓系統管理員提供隨附於顯示狀態原則的其他文字。例如，Description 可包含被指派原則的使用者相關資訊。 |
MaxCategorySubscription |
選用 |
整數 |
一次允許的類別目錄訂閱數目上限。類別目錄訂閱代表對特定資訊類別目錄的要求，例如要求行事曆資料的應用程式。 MaxCategorySubscription 可以設定為介於 0 和 3000 之間的任何整數值；預設值為 1000。 |
MaxPromptedSubscriber |
選用 |
整數 |
任何時候使用者可以同時具有的升級訂閱者數上限。根據預設，每次您被新增至其他使用者的連絡人清單時，都會顯示一個通知對話方塊告知您此情況，並提供您將該人員新增至自己的連絡人清單或是封鎖該人員檢視您目前狀態的機會。在您採取動作並關閉對話方塊之前，每個通知都會被視為一個已提示的訂閱者。 MaxPromptedSubscriber 可以設為任何介於 0 與 600 (含) 之間的整數值；預設值為 200。如果您將此值設為 0，則使用者將不會在被其他人新增至連絡人清單時收到任何通知。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 物件。Set-CsPresencePolicy 接受管線傳送的目前狀態原則物件輸入。
傳回類型
Set-CsPresencePolicy 不會傳回任何值或物件。而是此指令程式會修改 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300
範例 1 所示的命令會修改個別使用者目前狀態原則 RedmondPresencePolicy。在此範例中，MaxPromptedSubscriber 屬性的值設為 300。
-------------------------- 範例 2 ------------------------
Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300
範例 2 所示的命令是範例 1 中使用的命令變化；不過，在此例中，系統會針對設定為在組織中使用的所有目前狀態原則，將 MaxPromptedSubscriber 屬性設為 300。若要這樣做，此命令會先呼叫不含任何參數的 Get-CsPresencePolicy；這樣會傳回設定為在組織中使用的所有目前狀態原則集合。接著，此集合會傳送到 Set-CsPresencePolicy，將集合中每個原則的 MaxPromptedSubscriber 值變更為 300。
-------------------------- 範例 3 ------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300
範例 3 會示範如何設定組織中的目前狀態原則，以確保沒有原則允許 300 個以上的已提示訂閱者。若要執行此工作，此命令會先呼叫 Get-CsPresencePolicy 且不搭配任何參數，以傳回組織中所有目前狀態原則的集合。接著，此集合會傳送到 Where-Object 指令程式，只挑出其中 MaxPromptedSubscriber 原則之值大於 300 的原則。然後，這個篩選過的集合會傳送到 Set-CsPresencePolicy，以取得集合中的每個原則，並將已提示的訂戶數目上限設為 300。因此，不會有原則允許多於 300 個已提示的訂戶，但會有些原則可能會允許少於 300 個訂戶。