Get-CsOutboundTranslationRule
上次修改主題的時間： 2012-03-23
擷取一或多個輸出轉譯規則。輸出轉譯規則會將電話號碼轉換為區域撥號格式，以與專用交換機 (PBX) 系統和公用交換電話網路 (PSTN) 閘道互動。
語法
Get-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsOutboundTranslationRule [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
呼叫此指令程式以擷取現有的輸出轉譯規則。Microsoft Lync Server 2010 會將電話號碼正規化成 E.164 格式。但是，有許多專用交換機 (PBX) 系統無法使用這個格式。將號碼傳送到 中繼伺服器 或閘道之前，輸出轉譯規則會將號碼轉譯為區域撥號格式。
每個輸出轉譯規則會與主幹組態相關聯。每個主幹組態都可以與多個輸出轉譯規則相關聯。因此，每個規則識別是由一個範圍以及在此範圍內之唯一名稱 (格式為 scope/name，例如 site:Redmond/OBR1) 所組成。規則會自動與同一個範圍的主幹組態產生關聯。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsOutboundTranslationRule Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsOutboundTranslationRule"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
您要擷取之輸出轉譯規則的唯一識別碼。Identity 是由範圍後面加上在每個範圍內的唯一名稱所組成 (例如 site:Redmond/OutboundRule1)。指定 Identity 的值會傳回最多一個輸出轉譯規則。 |
Filter |
選用 |
字串 |
執行萬用字元搜尋，它允許您將結果縮減為只有識別符合指定萬用字元字串的輸出轉譯規則。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取輸出轉譯規則，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。
傳回類型
此指令程式會擷取 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 類型的一或多個物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsOutboundTranslationRule
此範例會擷取 Lync Server 2010 部署的所有輸出轉譯規則。
-------------------------- 範例 2 --------------------------
Get-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
此範例會擷取單一輸出轉譯規則，也就是 Identity site:Redmond/Prefix Redmond 的規則。
-------------------------- 範例 3 --------------------------
Get-CsOutboundTranslationRule -Filter site:*
此範例會擷取所有網站層級的輸出轉譯規則。命令會呼叫 Get-CsOutboundTranslationRule 並搭配 site:* 的 Filter，這會傳回 Identity 值以字串 site: 為開頭的所有規則集合。