Set-CsLisServiceProvider
上次修改主題的時間： 2012-03-27
建立或修改由增強型 9-1-1 (E9-1-1) 網路路由提供者用於確認位置所提供之 Web 服務的相關資訊。
語法
Set-CsLisServiceProvider -CertFileName <String> -Password <SecureString> -ServiceProviderName <String> -ValidationServiceUrl <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
詳細描述
在啟用 E9-1-1 的 Enterprise Voice 實作中，系統必須先透過 E9-1-1 網路路由提供者來路由傳送緊急通話，以確保將通話路由傳送至合適的公眾安全回應點 (PSAP) (PSAP 是在美國的一個機構，這個機構會將來電導向至最近的緊急服務，例如警察、消防以及救護車服務)。為了完成這項作業，提供者必須先取得組織周圍的位置清單，然後再比對位置清單和主要街道地址指南中的內容，以確保所有位置的有效性。此指令程式會建立或修改關於提供者的資訊，包括提供者的名稱、組織將用於傳送位置之 Web 服務的 URL，以及安全 Web 服務的憑證和密碼。
您無法為指定的 E9-1-1 實作定義一個以上的服務提供者。除非此指令程式可以解析 Web 服務的 URL 和安全性資訊，否則將無法成功。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsLisServiceProvider Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisServiceProvider"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
CertFileName |
必要 |
字串 |
憑證檔的名稱 (和完整路徑)。此檔案的副檔名必須是 PFX。 |
Password |
必要 |
安全字串 |
在受密碼保護的檔案中包含存取憑證所需之密碼的安全字串。使用 ConvertTo-SecureString 指令程式或 Read-Host 指令程式搭配 AsSecureString 參數，可以建立安全字串。 |
ServiceProviderName |
必要 |
字串 |
E9-1-1 網路路由提供者的名稱。 |
ValidationServiceUrl |
必要 |
字串 |
Web 服務的 URL。這必須是安全 URL，其首碼為 https://。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
接受管線傳送之位置資訊伺服器 (LIS) 服務提供者物件的輸入。
傳回類型
此指令程式會建立或修改 System.Management.Automation.PSCustomObject 類型的物件。
範例
-------------------------- 範例 1 --------------------------
$p = Read-Host -AsSecureString
Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p
用於建立 E9-1-1 網路路由提供者 Web 服務項目的其中一個必要參數為包含存取憑證檔所需之密碼的安全字串。因此，此範例中的第一行是呼叫 Windows PowerShellRead-Host 指令程式。Read-Host 會提示使用者進行輸入。我們指定的參數 AsSecureString 會將輸入顯示為星號 (*)。我們已將此命令的結果指派給變數 $p。結果會是一個安全字串，此字串為使用者輸入的加密版本。換句話說，執行此命令會提示您輸入 Web 服務的密碼，並將該密碼以變數 $p 儲存。
既然有了密碼，我們就可以建立會存取 Web 服務的物件。我們可以呼叫 Set-CsLisServiceProvider 指令程式來完成此作業。我們會將數個參數傳遞到此指令程式。第一個是提供者的名稱，在此例中為 E911Provider。下一個提供的是 ValidationServiceUrl 的值，也就是 https://www.911contoso.com/validation/。請注意，這必須是「安全的網站」，其前置字元為 https 而非 http。接下來，我們輸入包含用於安全地存取此 Web 服務之憑證的檔案名稱，亦即 C:\MS-Contoso-Cert.pfx。最後，我們將變數 $p (包含具有 Web 服務密碼的安全字串) 傳遞到 Password 參數。