Grant-CsVoicePolicy
上次修改主題的時間： 2012-03-23
為一個或多個使用者或群組指定語音原則。
語法
Grant-CsVoicePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
這個指令程式會指定現有的個別使用者語音原則給使用者。語音原則可用來管理 Enterprise Voice 相關功能，例如同時響鈴 (每次有人撥打到您的辦公室電話時，能夠讓第二支電話響起) 和來電轉接。使用這個指令程式可為特定使用者指定啟用及停用這些功能的設定。
您可以使用下列格式呼叫命令，檢查使用者是否已授與個別使用者語音原則：Get-CsUser "<user name>" | Select-Object VoicePolicy。例如：
Get-CsUser "Ken Myer" | Select-Object VoicePolicy
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Grant-CsVoicePolicy Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsVoicePolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
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 |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串。接受代表已授與語音原則之使用者帳戶 Identity 的管線傳送字串值。
傳回類型
搭配 PassThru 參數使用時，會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Grant-CsVoicePolicy -Identity "Ken Myer" -PolicyName VoicePolicyRedmond
這個範例將 Identity 為 VoicePolicyRedmond 的語音原則指定給顯示名稱為 Ken Myer 的使用者。
-------------------------- 範例 2 --------------------------
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsVoicePolicy -PolicyName VoicePolicyRedmond
這個範例會將 Identity 為 VoicePolicyRedmond 的語音原則指派給 Finance OU 中的所有使用者：OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com。命令的第一部分會呼叫 Get-CsUser 指令程式，以便從指定的 OU 擷取啟用 Lync Server 2010 或 Office Communications Server的所有使用者。然後將此使用者集合傳送到 Grant-CsVoicePolicy 指令程式，它會將原則 VoicePolicyRedmond 指定給其中每一個使用者。