次の方法で共有


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 型のオブジェクトを戻します。