Get-CsLocationPolicy
上次修改主題的時間: 2012-03-23
傳回如何設定增強型 9-1-1 (E9-1-1) 位置資訊服務,或該服務是否已設定的相關資訊。E9-1-1 服務讓接聽緊急電話的人員能夠判定來電者的地理位置。
語法
Get-CsLocationPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsLocationPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
位置原則可用來套用和 E9-1-1 功能相關的設定。位置原則會判斷使用者是否已啟用 E9-1-1,如果是,則會決定緊急電話的行為。例如,您可以使用位置原則來定義組成緊急電話的數字 (在美國為 911)、是否應自動告知公司的安全部門,以及應如何路由傳送來電等等。此指令程式會擷取一或多個位置原則。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Get-CsLocationPolicy Cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsLocationPolicy"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
XdsIdentity |
要擷取之位置原則的唯一識別碼。若要擷取通用位置原則,請使用 Global 值。對於在站台範圍內建立的原則,這個值的格式將為 site:<site name>。其中 site name 是指在 Microsoft Lync Server 2010 部署中定義之站台的名稱 (例如 site:Redmond)。對於已在個別使用者範圍內建立的原則,此值將只是原則的名稱,例如 Reno。 |
Filter |
選用 |
字串 |
含有萬用字元的字串,這個字串可藉由比對原則的 Identity 值和萬用字元字串來擷取位置原則。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取位置原則資訊,而不是從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
Get-CsLocationPolicy 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsLocationPolicy
範例 1 會傳回組織中目前正在使用的所有位置原則集合。只要在不搭配任何參數的情況下呼叫 Get-CsLocationPolicy 即可完成這項作業。
-------------------------- 範例 2 --------------------------
Get-CsLocationPolicy -Identity Reno
範例 2 所示的命令只會傳回 Identity 等於 Reno 的位置原則。由於 Identity 必須是唯一的,因此這個命令最多只會傳回一個位置原則。
-------------------------- 範例 3 --------------------------
Get-CsLocationPolicy -Filter tag:*
上述命令使用 Filter 參數來傳回所有已在個別使用者範圍內設定的位置原則 (在個別使用者範圍內設定的原則可直接指派給使用者和網路站台)。萬用字元 tag:* 會要求 Get-CsLocationPolicy 將傳回的資料限制為 Identity 開頭為字串值 tag: 的位置原則。即便是在擷取個別原則時不需要指定 tag: 前置詞,您還是可以使用這個前置詞來篩選所有個別使用者原則。
-------------------------- 範例 4 --------------------------
Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $False}
範例 4 會傳回所有已停用增強型緊急服務的位置原則集合。為達成此目的,此命令會先使用 Get-CsLocationPolicy,以傳回所有目前在組織中使用的位置原則集合。接著將該集合傳送到 Where-Object 指令程式,然後 Where-Object 會套用篩選將傳回的資料限制為 EnhancedEmergencyServicesEnabled 屬性等於 (-eq) False ($False) 的原則。