Set-CsLocationPolicy
上次修改主題的時間： 2012-03-26
修改現有的位置原則。
語法
Set-CsLocationPolicy [-Identity <XdsIdentity>] [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
詳細描述
位置原則可用來套用與增強型 9-1-1 (E9-1-1) 功能和用戶端位置相關的設定。位置原則會判斷使用者是否已啟用 E9-1-1，如果是，則會決定緊急電話的行為。例如，您可以使用位置原則來定義組成緊急電話的數字 (在美國為 911)、是否應自動告知公司的安全部門，以及應如何路由傳送來電。此指令程式會修改現有的位置原則。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsLocationPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLocationPolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
您要修改之位置原則的唯一識別碼。若要修改通用位置原則，請使用 Global 值。對於在站台範圍內建立的原則，這個值的格式將為 site:<site name>。其中 site name 是指在 Microsoft Lync Server 2010 部署中定義之站台的名稱 (例如 site:Redmond)。對於已在個別使用者範圍內建立的原則，此值將只是原則的名稱，例如 Reno。 |
Instance |
選用 |
LocationPolicy |
位置原則物件的參照。此物件的類型必須是 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy，呼叫 Get-CsLocationPolicy 即可擷取此物件。擷取此物件、變更記憶體中的屬性，然後將物件參照當成值傳給此參數，以更新該位置原則。 |
ConferenceMode |
選用 |
ConferenceModeEnum |
如果已指定 ConferenceUri 參數的值，則 ConferenceMode 參數會決定第三方是否可參與該電話，或只能聆聽。可用的值有： - oneway：第三方只能聆聽來電者與公眾安全回應點 (PSAP) 接線員之間的對話。 - twoway：第三方可聆聽並參與來電者與 PSAP 接線員之間的通話。 |
ConferenceUri |
選用 |
字串 |
第三方的 SIP 統一資源識別項 (URI) (本案例中為電話號碼)，第三方將會加入任何所撥打緊急電話的電話會議中。例如，當有人撥打緊急電話時，公司的安全部門會接聽該電話，並聆聽電話內容或參與該電話 (取決於 ConferenceMode 屬性的值)。 字串長度必須為 1 到 256 字元，且開頭必須為前置字元 sip:。 |
Description |
選用 |
字串 |
此位置的詳細說明。例如，“Building 30, 3rd Floor, NorthEast corner”。 |
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 用戶端會在登錄時擷取位置資訊，並在撥打緊急電話時包含該資訊。 |
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) 使用方式，用於決定要使用哪一個語音路由來路由傳送來自使用此設定檔之用戶端的 911 電話。與此使用方式相關聯的路由傳送將指向緊急電話專用的 SIP 主幹。 使用方式必須已存在於 PSTN 使用方式的通用清單中。呼叫 Get-CsPstnUsage 指令程式可擷取使用方式清單。呼叫 Set-CsPstnUsage 指令程式可建立新的使用方式。 |
UseLocationForE911Only |
選用 |
布林值 |
Microsoft Lync 2010 用戶端使用位置資訊的原因有許多種 (例如通知組員目前的位置)。將此值設為 True 可確保位置資訊僅供搭配緊急電話使用。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 物件。接受管線傳送的位置原則物件輸入。
傳回類型
這個指令程式不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
此命令會使用 Set-CsLocationPolicy 指令程式，來修改 Identity 為 site:Redmond 的位置原則。(換句話說，它會修改已套用至 Redmond 站台的位置原則)。在此案例中，命令會將 EnhancedEmergencyServicesEnabled 屬性值設定為 True，這將針對所有已連線至 (在此案例中) Redmond 站台的使用者啟用 E9-1-1 功能。
-------------------------- 範例 2 --------------------------
Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway
範例 2 會修改用於組織中已定義會議 URI 的所有位置原則，以具備雙向會議模式。為了執行此作業，命令會先使用 Get-CsLocationPolicy，來傳回目前定義之所有位置原則的集合。然後將此集合傳送到 Where-Object 指令程式，以便將集合範圍縮小為只包含 ConferenceUri 屬性不是空白 (不等於 Null) 的位置原則。這會產生含 ConferenceUri 值的位置原則集合。然後將此集合傳送到 Set-CsLocationPolicy，接著則會藉由將值設定為雙向，來修改集合中每個原則的 ConferenceMode 屬性值。