Remove-CsPresencePolicy
上次修改主題的時間: 2012-03-26
移除指定的目前狀態原則。
語法
Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
目前狀態資訊十分有價值,它可讓您知道連絡人是否可參與立即訊息交談。但同時,使用目前狀態資訊也是有代價的:目前狀態訂閱的愈多,則必須有更多專供更新目前狀態資訊使用的網路頻寬。如果您擔心網路頻寬的問題,可以限制每個人的目前狀態訂閱數。
CsPresencePolicy 指令程式可讓您管理目前狀態資訊兩個重要的層面:已提示訂閱者與類別目錄訂閱。在將您新增到另一個人的 Microsoft Lync 2010 連絡人清單後,為您設定的預設行為是會收到快顯通知來告知已將您新增到該清單中。一直到您將快顯方塊關閉後,每個通知才能計算為一個已提示訂戶。目前狀態原則的 MaxPromptedSubscriber 屬性可讓您指定使用者可擁有的未解決通知對話方塊數目上限(如果使用者到達上限,就不會再收到新的連絡人通知,至少在某些對話方塊已關閉前不會)。
類別目錄訂閱代表要求特定的資訊目錄,例如要求行事曆資訊的應用程式。MaxCategorySubscription 屬性可讓您設定使用者可擁有的類別目錄訂閱數限制。
Microsoft Lync Server 2010 之前版本的已提示訂閱者與類別目錄訂閱是通用管理的。透過 CsPresencePolicy 指令程式,您現在可以在全域範圍、站台範圍,甚至是個別使用者範圍管理目前狀態訂閱。這可讓您控制頻寬的使用,同時確保使用者能夠存取工作所需的目前狀態資訊。
在站台範圍或個別使用者範圍內建立的原則,隨時都可藉由執行 Remove-CsPresencePolicy 指令程式來移除。此指令程式也可以根據通用原則來執行;但如果這麼做,並不會真的移除通用原則 (Lync Server 2010 不允許您移除通用原則)。而是將通用原則的兩個屬性 (MaxPromptedSubscriber 和 MaxCategorySubscription) 重設為預設值。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsPresencePolicy Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPresencePolicy"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除之目前狀態原則的唯一識別碼。若要移除已設定於站台範圍內的原則,可使用類似下列的語法:-Identity "site:Redmond"。若要移除已設定於個別使用者範圍內的原則,請使用類似下列的語法:-Identity "RedmondPresencePolicy"。 Remove-CsPresencePolicy 也可以根據通用原則來執行;若要執行這項操作,可使用下列語法:-Identity global。但是,請注意,系統不會移除通用原則。而是將該原則內的屬性重設為其預設值。 |
Force |
選用 |
切換參數 |
如果存在,將導致 Remove-CsPresencePolicy 刪除個別使用者原則,即使原則目前已指派給至少一位使用者也一樣。如果不存在,系統將要求您在移除仍在使用中的原則之前,先確認刪除要求。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 物件。Remove-CsPresencePolicy 會接受目前狀態原則物件的管線傳送資料。
傳回類型
無。而 Remove-CsPresencePolicy 會刪除 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"
上述命令會刪除 Identity 為 RedmondPresencePolicy 的個別使用者目前狀態原則。
-------------------------- 範例 2 ------------------------
Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy
範例 2 所示的命令會移除所有已設定於個別使用者範圍內的目前狀態原則 (這些原則的 Identity 都會以前置詞 "tag:" 開頭)為了執行此作業,命令會先使用 Get-CsPresencePolicy 搭配 Filter 參數,傳回所有個別使用者目前狀態原則;篩選值 "tag:*" 會將傳回的資料限制為 Identity 是以字串值 "tag:" 開頭的原則。然後將篩選過的集合傳送到 Remove-CsPresencePolicy,這會刪除集合中的每個原則。
-------------------------- 範例 3 ------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | Remove-CsPresencePolicy
範例 3 會刪除所有允許超過 500 位提示訂閱者的目前狀態原則。為達成此目的,命令會先呼叫 Get-CsPresencePolicy 且不指定任何參數,以傳回設定為要在組織內使用的所有目前狀態原則集合。然後將此集合傳送到 Where-Object 指令程式,這樣只會挑出 MaxPromptedSubscriber 屬性大於 500 的原則。接著將篩選過的集合傳送到 Remove-CsPresencePolicy,這會刪除所有允許超過 500 位提示訂閱者的目前狀態原則。