Get-CsVoiceRoute
上次修改主題的時間： 2012-03-23
傳回為已設定用於組織之語音路由的相關資訊。
語法
Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceRoute [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
使用此指令程式來擷取一或多個現有的語音路由。語音路由包含一些指示，告知 Microsoft Lync Server 2010 如何將 Enterprise Voice 使用者的來電轉接至公用交換電話網路 (PSTN) 或專用交換機 (PBX) 上的電話號碼。
此指令程式可用來擷取語音路由的資訊，例如：與路由相關聯的 PSTN 閘道 (若有的話)、與路由相關聯的 PSTN 使用方式、識別套用路由之電話號碼的模式 (格式為規則運算式)，以及來電者識別碼設定。PSTN 使用方式會讓語音路由與語音原則產生關聯。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsVoiceRoute Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoiceRoute"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsGlobalRelativeIdentity |
可唯一識別語音路由的字串。如果未提供識別，則傳回組織的所有語音路由。 |
Filter |
選用 |
字串 |
此參數會根據傳遞給此參數的萬用字元值，篩選 Get 作業的結果。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取語音路由，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。
傳回類型
此指令程式會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsVoiceRoute
擷取組織內定義的所有語音路由的屬性。
-------------------------- 範例 2 --------------------------
Get-CsVoiceRoute -Identity Route1
擷取 Route1 語音路由的屬性。
-------------------------- 範例 3 --------------------------
Get-CsVoiceRoute -Filter *test*
此命令會顯示 Identity 值內任何位置含有 "test" 字串的語音路由設定。若只要尋找 Identity 尾端的 test 字串，請使用 *test 值。同樣地，若只要尋找 Identity 開頭出現的 test 字串，請指定 test* 值。
-------------------------- 範例 4 --------------------------
Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}
此命令會擷取尚未指派任何 PSTN 閘道的所有語音路由 首先會使用 Get-CsVoiceRoute 指令程式來擷取所有語音路由。然後，將這些語音路由傳送給 Where-Object 指令程式。Where-Object 會縮減 Get 作業的結果。在此例子中，我們查看每一個語音路由 (也就是 $_ 所代表的意義)，並檢查 PstnGatewayList 屬性的 Count 屬性。如果 PSTN 閘道的計數是 0，則清單為空白，表示路由未定義任何閘道。