Test-CsLocationPolicy
上次修改主題的時間： 2012-03-26
執行測試以便根據參數值中指定的條件，決定將使用的位置原則。位置原則中包含將會決定是否套用以及如何套用增強型 9-1-1 (E9-1-1) 的設定。E9-1-1 可讓接聽 911 緊急通話的人員判斷來電者的地理位置。
語法
Test-CsLocationPolicy -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]
Test-CsLocationPolicy [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>]
詳細描述
位置原則用來套用與 E9-1-1 功能和用戶端位置相關的設定。位置原則會判斷使用者是否已啟用 E9-1-1，如果是，則會決定緊急電話的行為。例如，您可以使用位置原則來定義組成緊急電話的數字 (在美國為 911)、是否應自動告知公司的安全部門，以及應如何路由傳送來電。此指令程式會傳回在特定集區、子網路、交換器、或無線存取點上的特定用戶端撥打電話時，將使用之位置原則的相關資訊。
如果此指令程式的呼叫中未指定使用者，則將測試目前設定的使用者。若要尋找目前設定的使用者，請呼叫 Get-CsHealthMonitoringConfiguration。若要設定已設定的使用者，請呼叫 Set-CsHealthMonitoringConfiguration。
如果找到使用者或子網路的位置原則，測試將會成功。預設傳回的資訊包括位置原則的名稱 (如果指派個別使用者原則) 以及使用者或子網路是否啟用 E9-1-1。加入 Windows PowerShell 一般參數詳細資訊以擷取關於測試的其他資訊。
您可以針對使用者或網路子網路測試位置原則。如果您針對子網路執行測試 (透過指定 Subnet 參數的值)，指令程式就會嘗試解析該子網路的位置原則。如果該子網路未指派位置原則，則會擷取已設定之使用者的位置原則。如果成功擷取子網路原則，則輸出將包含開頭為 subnet-tagid 的 LocationPolicyTagID 值。如果找不到子網路的位置原則，則 LocationPolicyTagID 的開頭為 user-tagid。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Test-CsLocationPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsLocationPolicy"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
TargetFqdn |
必要 |
字串 |
指定使用者或子網路所屬之集區的完整網域名稱 (FQDN) (如果未指定使用者，則會假設為預先設定或目前的使用者)。 |
OutVerboseVariable |
選用 |
字串 |
如果有，執行 Cmdlet 所產生的詳細輸出就會儲存在指定變數中。例如，您可使用下列語法，將輸出儲存於名為 $TestOutput 的變數中： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
RegistrarPort |
選用 |
整數 |
登錄器服務的連接埠號碼。 |
Subnet |
選用 |
字串 |
您想要測試其位置原則之網路子網路的 ID (IP 位址)。 |
UserCredential |
選用 |
PS 認證物件 |
包含正在測試其位置原則之使用者帳戶的使用者 ID 和密碼的物件。您可以呼叫 Windows PowerShellGet-Credential 指令程式、填入適當的資訊，並將輸出儲存為變數來擷取認證物件。 |
UserSipAddress |
選用 |
SIP 位址 |
您想要測試其位置原則之使用者的 SIP 位址。其格式必須為 sip:<user id>，例如 sip:kenmyer@litwareinc.com。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
輸入類型
無。
傳回類型
Test-CsLocationPolicy 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com
此範例會判斷目前使用者 (或目前設定的使用者) 的位置原則。TargetFqdn 為必要項。
-------------------------- 範例 2 --------------------------
$cred = Get-Credential "litwareinc\kenmyer"
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred -UserSipAddress "sip:kenmyer@litwareinc.com"
範例 2 中的第一行是呼叫 Windows PowerShell Get-Credential 指令程式。此指令程式會擷取使用者認證，並當做安全性物件將其傳回。唯一提供給此指令程式的參數為使用者識別碼。執行此指令程式會開啟一個對話方塊，其中會預先填入提供的使用者識別碼，而且會有一個可讓您輸入使用者密碼的文字方塊。這些使用者認證會儲存為變數 $cred。
第 2 行會呼叫 Test-CsLocationPolicy 指令程式。與範例 1 類似，我們提供目標 FQDN。不過，在此範例中使用的不是預先設定的使用者，我們會針對 SIP 位址為 kenmyer@litwareinc.com 的使用者執行測試。我們將該值 (含 sip:首碼) 傳遞至 UserSipAddress 參數，而該使用者的認證 (以 $cred 變數儲存) 會傳遞至 UserCredential 參數。
-------------------------- 範例 3 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com"
此範例和範例 2 類似，但不會指定使用者認證。未指定使用者認證呼叫 Test-CsLocationPolicy 時，執行這個指令程式的電腦上的伺服器憑證會被用來驗證及探索使用者的位置原則。如果電腦沒有伺服器憑證，您必須依範例 2 所示指定憑證。呼叫 Get-CsCertificate 指令程式，藉此找出電腦上是否有伺服器憑證。
-------------------------- 範例 4 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -Subnet 172.15.11.0
此範例會判斷子網路 ID 為 172.15.11.0 之子網路的位置原則。如果子網路未與位置原則相關聯，則會擷取目前設定之使用者的位置原則。
附註：位置原則是在子網路上設定，方法為，將 Set-CsNetworkSite 指令程式的 LocationPolicy 參數設為位置原則識別碼，然後將 Set-CsNetworkSubnet 指令程式的 NetworkSiteId 參數設為該網站的識別碼。例如：
Set-CsNetworkSite Portland –LocationPolicy Reno
Set-CsNetworkSubnet 175.15.11.0 –NetworkSiteID Portland