Grant-CsDialPlan
上次修改主題的時間： 2012-03-23
為一個或多個使用者或群組指定撥號對應表。
語法
Grant-CsDialPlan -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
這個指令程式會指定現有的使用者專用撥號對應表給使用者。撥號對應表提供可讓 Enterprise Voice 使用者撥打電話所需的資訊。沒有有效撥號對應表的使用者將無法使用 Enterprise Voice 撥打電話。撥號對應表會決定如何套用正規化規則，以及撥打外線時是否必須撥首碼。
您可以使用下列格式呼叫命令，檢查使用者是否已授與個別使用者撥號對應表：Get-CsUser "<user name>" | Select-Object DialPlan。例如：
Get-CsUser "Ken Myer" | Select-Object DialPlan
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Grant-CsDialPlan Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsDialPlan"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserIdParameter |
為其指定撥號對應表之使用者的 Identity (唯一識別碼)。 可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (如 litwareinc\kenmyer)；4) 使用者的 Active Directory 顯示名稱 (如 Ken Myer)。 請注意，使用顯示名稱作為使用者 Identity 時，可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回姓氏為 Smith 的所有使用者。 完整資料類型：Microsoft.Rtc.Management.AD.UserIdParameter |
PolicyName |
選用 |
字串 |
要指派給使用者的撥號對應表之 Identity 值。(請注意，這只包括 Identity 的名稱部分。個別使用者撥號對應表識別身分包括首碼 tag:，PolicyName 不應該包含此首碼)。 |
DomainController |
選用 |
Fqdn |
容許您指定網域控制站。若未指定網域控制站，則會使用第一個可用的網域控制站。 |
PassThru |
選用 |
切換參數 |
傳回命令的結果。根據預設，這個指令程式不會產生任何輸出。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串。接受代表使用者帳戶 (已被授與撥號對應表) 識別的管線字串值。
傳回類型
搭配 PassThru 參數使用時，會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan
在上面所示的範例中，Grant-CsDialPlan 用於將撥號對應表 RedmondDialPlan 指派給含有 Identity (在此例中為顯示名稱) Ken Myer 的使用者。
-------------------------- 範例 2 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan
在範例 2 中，RedmondDialPlan 撥號對應表會指派給辦公室位於 Redmond 市的全部使用者。為了執行這項作業，會呼叫 Get-CsUser 指令程式，以便擷取辦公室位於 Redmond 城市之全部使用者的集合；方法是使用 LDAPFilter 參數和 LDAP query l=Redmond。(在 Active Directory 網域服務 (AD DS) 所使用的 LDAP 查詢語言中，l 表示使用者的位置或城市)。這個集合便會傳送到 Grant-CsDialPlan，這會將 Redmond 撥號對應表指派給集合中的每個使用者。