Grant-CsHostedVoicemailPolicy
トピックの最終更新日: 2012-03-23
ホスト ボイス メール ポリシーをユーザーごとのスコープで割り当てます (ユーザーごとのスコープにより、ポリシーを個々のユーザーまたはグループに割り当てることができます)。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Grant-CsHostedVoicemailPolicy -Identity <UserIdParameter> -PolicyName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
例
例 1
この例では、ExRedmond の Identity を持つホスト ボイス メール ポリシーを、Ken Myer の表示名のユーザーに割り当てます。
Grant-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond
例 2
この例では、ExRedmond という Identity を持つホスト ボイス メール ポリシーを Finance 組織単位 (OU) OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com のすべてのユーザーに割り当てます。このコマンドの最初の部分では、Get-CsUser コマンドレットを呼び出して、Lync Server または Office Communications Server に対して有効なすべてのユーザーを指定の OU から取得します。次に、このユーザーのコレクションを Grant-CsHostedVoicemailPolicy コマンドレットにパイプ処理して、ポリシー ExRedmond を各ユーザーに割り当てます。
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsHostedVoicemailPolicy -PolicyName ExRedmond
解説
このコマンドレットは、既存のユーザー固有のホスト ボイス メール ポリシーをユーザーに割り当てます。ホスト ボイス メール ポリシーでは、不在時着信の Exchange ユニファイド メッセージング (UM) ホスト サービスへのルーティング方法を指定します。
次の形式のコマンドを呼び出して、ユーザーにユーザーごとのホスト ボイス メール ポリシーが付与されているかどうか確認できます。Get-CsUser "<ユーザー名>" | Select-Object HostedVoicemailPolicy。次に例を示します。
Get-CsUser "Ken Myer" | Select-Object HostedVoicemailPolicy
ユーザーに宛先が設定されていないホスト ボイス メール ポリシーを割り当てると、そのユーザーはホスト ボイス メールを使用できません。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが Grant-CsHostedVoicemailPolicy コマンドレットのローカルでの実行を承認されています。RTCUniversalUserAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsHostedVoicemailPolicy"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
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 型のオブジェクトを戻します。