Grant-CsVoicePolicy
トピックの最終更新日: 2012-03-23
音声ポリシーを 1 人以上のユーザーまたは 1 つ以上のグループに割り当てます。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Grant-CsVoicePolicy -Identity <UserIdParameter> -PolicyName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
例
例 1
この例では、VoicePolicyRedmond の ID を持つ音声ポリシーを、Ken Myer の表示名のユーザーに割り当てます。
Grant-CsVoicePolicy -Identity "Ken Myer" -PolicyName VoicePolicyRedmond
例 2
この例では、VoicePolicyRedmond という ID を持つ音声ポリシーを、OU=Finance,OU-NorthAmerica,DC=litwareinc,DC=com という Finance OU 内のすべてのユーザーに割り当てます。このコマンドの最初の部分では、Get-CsUser コマンドレットを呼び出して、Lync Server または Office Communications Server が有効になっているすべてのユーザーを指定の OU から取得します。次に、このユーザーのコレクションは Grant-CsVoicePolicy コマンドレットにパイプ処理され、ポリシー VoicePolicyRedmond がこれらの各ユーザーに割り当てられます。
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsVoicePolicy -PolicyName VoicePolicyRedmond
解説
このコマンドレットは、既存のユーザーごとの音声ポリシーをユーザーに割り当てます。音声ポリシーは、同時呼び出し (会社の電話への着信時に 2 番目の電話を呼び出す機能) や自動転送などの、エンタープライズ VoIP 関連機能の管理に使用されます。これらの機能を有効および無効にする設定を特定のユーザーに割り当てる場合に、このコマンドレットを使用します。
次の形式のコマンドを呼び出して、ユーザーにユーザーごとの音声ポリシーが付与されているかどうか確認できます。Get-CsUser "<ユーザー名>" | Select-Object VoicePolicy。次に例を示します。
Get-CsUser "Ken Myer" | Select-Object VoicePolicy
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーは Grant-CsVoicePolicy コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsVoicePolicy"}
パラメーター
| パラメーター | 必須 | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Rtc.Management.AD.UserIdParameter |
ポリシーを割り当てるユーザーの ID (一意の識別子) です。 ユーザーの Identity は、以下の 4 つの形式のうちの 1 つを使用して指定できます。1) ユーザーの SIP アドレス、2) ユーザー プリンシパル名 (UPN)、3) ドメイン\ログオン形式 (litwareinc\kenmyer など) のユーザーのドメイン名とログオン名、および 4) ユーザーの Active Directory 表示名 (Ken Myer など)。 表示名をユーザーの Identity として使用する場合は、アスタリスク (*) ワイルドカード文字を使用できる点に留意してください。たとえば、"* Smith" という Identity を指定すると、Smith という姓のユーザーがすべて戻されます。 完全なデータ型:Microsoft.Rtc.Management.AD.UserIdParameter |
PolicyName |
必須 |
System.String |
ユーザーに割り当てる音声ポリシーの名前 (ID) です。(このパラメーターには、Identity の名前の部分のみが含まれる点に留意してください。ユーザーごとのポリシー ID には tag: というプレフィックスを指定します。PolicyName と共に指定することはできません。) |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
DomainController |
省略可能 |
Microsoft.Rtc.Management.Deploy.Fqdn |
ドメイン コントローラーを指定できます。ドメイン コントローラーを指定しない場合は、最初に使用可能なものが使用されます。 |
PassThru |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの結果を戻します。既定では、このコマンドレットによる出力はありません。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
入力の種類
文字列。音声ポリシーの割り当て先ユーザー アカウントの ID を表す、パイプ処理された文字列値を受け入れます。
戻り値の種類
PassThru パラメーターと共に使用する場合は、Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 型のオブジェクトを戻します。