Get-CsVoiceNormalizationRule
上次修改主題的時間： 2012-03-23
傳回組織中使用的語音正規化規則的相關資訊。語音正規化規則將電話撥號需求 (例如，撥 9 來撥接外線) 轉換為 Microsoft Lync Server 2010 使用的 E.164 電話號碼格式。
語法
Get-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceNormalizationRule [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
此指令程式會傳回具名的語音正規化規則或一組語音正規化規則。這些規則是電話授權和電話轉接的必要部分。這些規則定義將號碼從內部 Lync Server 2010 格式轉換 (或轉譯) 為標準 (E.164) 格式的需求。了解規則運算式對於定義將要轉譯的號碼模式很有幫助。
此指令程式所存取的相同規則，也可以透過呼叫 Get-CsDialPlan 指令程式所傳回的 NormalizationRules 屬性來存取。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsVoiceNormalizationRule Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoiceNormalizationRule"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
規則的唯一識別碼。如果指定此參數的值，它必須是「範圍/名稱」格式；例如，site:Redmond/Rule1，其中 site:Redmond是範圍，Rule1 是名稱。 |
Filter |
選用 |
Xds 識別碼篩選 |
使用萬用字串，以根據 Identity 傳回正規化規則的集合。請注意，Filter 僅適用於 Identity 的範圍部分，不適用於名稱部分。例如，篩選值 *lob* 會傳回全域範圍 (含字母 lob 的範圍) 的所有規則，而不是 Identity 為 site:Redmond/lobby 的規則，其中 lob 只會位於 Identity 的名稱部分，而不會在範圍部分。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取語音正規化規則，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。
傳回類型
Get-CsVoiceNormalizationRule 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsVoiceNormalizationRule
此範例會擷取組織已定義的所有語音正規化規則。
-------------------------- 範例 2 --------------------------
Get-CsVoiceNormalizationRule -Filter site*
範例 2 會擷取所有網站已指定的所有語音正規化規則。
-------------------------- 範例 3 --------------------------
Get-CsVoiceNormalizationRule -Filter *s*
範例 3 會擷取範圍中任何出現字母 s 之處的所有語音正規化規則。例如，這樣會傳回範圍名稱中出現 s (例如 RedmondEastUsers) 的所有網站層級、服務層級以及個別使用者的規則。
-------------------------- 範例 4 --------------------------
Get-CsVoiceNormalizationRule | Where-Object {$_.Name -match "seattle"}
範例 2 和 3 中使用的 Filter 參數只比對 Identity 的範圍部分。此範例會在名稱部分執行比對，以傳回名稱中含有 "seattle" 字串的所有規則。為此，我們先呼叫 Get-CsVoiceNormalizationRule 以擷取組織的所有正規化規則。接著，我們將此集合傳送給 Where-Object 指令程式，以在集合中尋找 Name 屬性符合 "seattle" 字串的所有項目。