Remove-CsLocationPolicy
上次修改主題的時間： 2012-03-27
移除指定的位置原則 (位置原則是搭配增強型 911 服務使用，讓接聽 911 電話的人員可以根據電話號碼或撥打電話的裝置，判斷來電者的地理位置)。
語法
Remove-CsLocationPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
位置原則用來套用與 E9-1-1 功能相關的設定。位置原則會判斷使用者是否已啟用 E9-1-1，如果是，則會決定緊急電話的行為。例如，您可以使用位置原則來定義組成緊急電話的數字 (在美國為 911)、是否應自動告知公司的安全部門，以及應如何路由傳送來電。此指令程式會移除現有的位置原則。
除了移除網站和個別使用者位置原則之外，此指令程式也可以用來移除通用位置原則。但在此情況下，不會真的移除原則；而只是將原則設定重設為預設值。
如果是針對指派給使用者的個別使用者位置原則執行此指令程式，系統會提示您確認刪除。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsLocationPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLocationPolicy"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
您要移除之位置原則的唯一識別碼。若要移除通用位置原則 (只是將該原則重設為其預設值)，請使用 Global 的值。對於在站台範圍內建立的原則，這個值的格式將為 site:<site name>。其中 site name 是指在 Microsoft Lync Server 2010 部署中定義之站台的名稱 (例如 site:Redmond)。針對在個別使用者範圍建立的原則，此值即為原則名稱，例如 Bldg30Floor3Sector1。 |
Force |
選用 |
切換參數 |
指定此參數將會略過所有確認提示，而且會在毫無警告通知的狀況下進行刪除。例如，如果有一個個別使用者位置原則指派給一或多個使用者，當命令中沒有加入此參數時，將會在刪除之前顯示確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 物件。接受管線傳送的位置原則物件輸入。
傳回類型
這個指令程式不會傳回值或物件，而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Remove-CsLocationPolicy -Identity Reno
範例 1 所示的命令會使用 Remove-CsLocationPolicy 刪除 Identity 為 Reno 的位置原則。移除個別使用者原則時，被指派該原則的使用者或群組將會自動改用針對其網站設定的原則。如果未針對其網站設定原則，這些使用者及群組將會使用通用位置原則。
-------------------------- 範例 2 --------------------------
Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $false} | Remove-CsLocationPolicy
範例 2 會刪除 EnhancedEmergencyServicesEnabled 屬性為 False 的所有位置原則 (換句話說，它會刪除不啟用 E9-1-1 的所有位置原則)。若要這樣做，此命令會先使用 Get-CsLocationPolicy 擷取組織中目前使用中的所有位置原則。然後，此集合會傳送到 Where-Object 指令程式；這會套用一個篩選，將擷取的資料限制為 EnhancedEmergencyServicesEnabled 屬性等於 (-eq) False ($False) 的原則。最後，這個篩選過的集合會傳送到 Remove-CsLocationPolicy，以繼續刪除集合中的每個原則。