New-CsLocationPolicy
上次修改主題的時間： 2012-03-26
建立新的位置原則以使用增強型 9-1-1 (E9-1-1) 服務的位置識別和一般用戶端位置。E9-1-1 服務讓接聽 911 來電的人員能夠判定來電者的地理位置。
語法
New-CsLocationPolicy -Identity <XdsIdentity> [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
詳細描述
位置原則用於將相關的 E9-1-1 功能與位置設定套用到使用者或連絡人。位置原則會判斷使用者是否已啟用 E9-1-1，如果是，則會決定緊急電話的行為。例如，您可以使用位置原則來定義組成緊急電話的數字 (在美國為 911)、是否應自動告知公司的安全部門，以及應如何路由傳送來電。此指令程式會在網站或個別使用者範圍處建立新的位置原則(全域範圍中已有原則)。
重要：位置原則的行為在範圍順序方面與 Lync Server 2010 中的其他原則不同。對於其他的所有原則，如果原則是在個別使用者範圍中定義，則該原則會套用至任何授與該原則的使用者。如果使用者尚未授與個別使用者原則，則會套用網站原則。如果沒有網站原則，則會套用通用原則。系統也會以相同方式套用位置原則，但有一例外：系統也會將個別使用者位置原則指派給網站 (網站由一組子網路構成)。如果使用者正從對應到組織內部網站的位置撥打緊急電話，則會使用指派給該網站的使用者層級原則。此功能會覆寫已經授與給該使用者的個別使用者原則。如果使用者從未知或組織中未對應的位置撥打電話，將會套用標準原則範圍。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsLocationPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsLocationPolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
位置原則的唯一識別碼。可使用此指令程式在網站或個別使用者範圍建立原則。(根據預設通用原則存在且無法移除)。若是在網站範圍建立的原則，這個值的格式必須是 site:<site name>，其中 site name 是在 Microsoft Lync Server 2010 部署中定義的網站名稱。例如，site:Redmond。任何的字串值，例如 Reno，皆可指派給建立在個別使用者範圍的原則。 |
ConferenceMode |
選用 |
ConferenceModeEnum |
如果已指定 ConferenceUri 參數的值，則 ConferenceMode 參數會決定第三方是否可參與該電話，或只能聆聽。可用的值有： - oneway：第三方只能聆聽來電者與公眾安全回應點 (PSAP) 接線員之間的對話。 - twoway：第三方可聆聽並參與來電者與 PSAP 接線員之間的通話。 |
ConferenceUri |
選用 |
字串 |
第三方的 SIP 統一資源識別項 (URI) (本案例中為電話號碼)，第三方將會加入任何所撥打緊急電話的電話會議中。例如，當有人撥打緊急電話時，公司的安全部門會接聽該電話，並聆聽電話內容或參與該電話 (取決於 ConferenceMode 屬性的值)。 字串長度必須為 1 到 256 字元，且開頭必須為前置字元 sip:。 |
Description |
選用 |
字串 |
此位置的詳細說明。例如，「Reno 公司使用者」。 |
EmergencyDialMask |
選用 |
字串 |
所撥打的號碼會轉譯成 EmergencyDialString 屬性的值。例如，若 EmergencyDialMask 的值為 "212"，而 EmergencyDialString 的值為 "911"，如果使用者撥打 212，通話會轉接至 911。如此即可撥打替代的緊急電話號碼，而且依然可以讓電話轉接到緊急服務 (例如，若某個國家/地區的緊急電話號碼不同，來自該國家/地區的人會嘗試撥打該國家/地區的緊急電話號碼，而非所在國家/地區的緊急電話號碼)。您可以使用分號分隔多個值，藉此定義多組緊急撥話遮罩。例如，-EmergencyDialMask “212;414”。 重要。確保指定的撥號遮罩值與通話保留範圍中的數字不同。通話保留路由優先於緊急撥號字串轉換。呼叫 Get-CsCallParkOrbit 指令程式可以查看現有的通話保留範圍。 字串的長度上限為 100 字元。每個字元必須是 0 到 9 的數字。 |
EmergencyDialString |
選用 |
字串 |
聯絡緊急服務時所撥打的號碼。此值在美國為 911。 字串必須由 0 到 9 的數字組成，長度可為 1 到 10 位數字。 |
EnhancedEmergencyServicesEnabled |
必要 |
布林值 |
指定與此原則關聯的使用者是否已啟用 E9-1-1 功能。將值設為 True 可啟用 E9-1-1，所以 Lync Server 2010 用戶端會在登錄時擷取位置資訊，並在撥打緊急電話時包含該資訊。 預設值：False |
LocationRequired |
選用 |
LocationRequiredEnum |
如果用戶端無法從位置組態資料庫擷取位置，則會提示使用者手動輸入位置。此參數接受下列值： - no：將不會提示使用者輸入位置。當撥打的電話沒有位置資訊時，緊急服務供應商將接聽來電，並要求提供位置。 - yes：當用戶端在新位置登錄時，會提示使用者輸入位置資訊。使用者可以不輸入任何資訊而將提示關閉。如果輸入資訊，則撥打到 911 的電話會先由緊急服務供應商接聽以確認位置，然後再路由傳送到 PSAP 接線員 (911 接線員)。 - disclaimer：此選項與 yes 相同，但是當使用者關閉提示時，則會顯示免責聲明文字，警告使用者拒絕輸入位置資訊的後果 (免責聲明文字必須透過呼叫 Set-CsEnhancedEmergencyServiceDisclaimer Cmdlet 設定)。 如果 EnhancedEmergencyServicesEnabled 設為 False (預設值)，則會忽略此值。系統將不會提示使用者輸入位置資訊。 |
NotificationUri |
選用 |
字串 |
撥打緊急電話時所通知的一或多個 SIP URI。例如，每次有人撥打緊急電話時，就會透過立即訊息通知公司的安全部門。如果可以使用來電者的位置，通知中會包含該位置的資訊。 可以使用逗號分隔的清單包含多個 SIP URI。例如，-NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com。請記住，系統不支援該通訊清單及群組 URI。 字串長度必須為 1 到 256 字元，且開頭必須為前置字元 sip:。 |
PstnUsage |
選用 |
字串 |
公用交換電話網路 (PSTN) 的使用方式，用於決定要使用哪一個語音路由來路由傳送來自使用此設定檔之用戶端的緊急電話。與此使用方式相關聯的路由傳送將指向緊急電話專用的 SIP 主幹。 使用方式必須已存在於 PSTN 使用方式的通用清單中。呼叫 Get-CsPstnUsage 指令程式可擷取使用方式清單。呼叫 Set-CsPstnUsage 指令程式可建立新的使用方式。 |
UseLocationForE911Only |
選用 |
布林值 |
Microsoft Lync 2010 用戶端使用位置資訊的原因有許多種 (例如通知組員目前的位置)。將此值設為 True 可確保位置資訊僅供搭配緊急電話使用。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
範例 1 使用 New-CsLocationPolicy 為 Redmond 網站建立新的位置原則，以啟用該網站所有使用者的 E9-1-1 功能。若要建立新原則，請呼叫 New-CsLocationPolicy 並搭配以下兩個參數：一個參數用於設定 Identity，在本例中為字串 site:後面加上要套用此原則的網站名稱；另一個參數用於將 EnhancedEmergencyServicesEnabled 屬性的值設為 True。
-------------------------- 範例 2 --------------------------
New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911
此範例會建立個別使用者位置原則(必須特別將個別使用者原則授予各個使用者或群組)。此原則的 Identity 為 Reno。我們已使用 Description 參數，新增更詳細的原則描述。我們提供的下一個參數為 EnhancedEmergencyServicesEnabled，若設為 True 則會開啟已授予此原則之所有使用者的 E9-1-1 功能。接下來的參數為 PstnUsage，在本例中的值為 Emergency。此值必須符合 PSTN 使用方式清單中的值(呼叫 Get-CsPstnUsage 可擷取此清單)。使用方式應與用於緊急電話的語音路由產生關聯(您可以呼叫 Get-CsVoiceRoute 指令程式來擷取語音路由)。本範例中使用的最後一個參數是 EmergencyDialString，它會指定所撥打之代表緊急電話的號碼。