Get-CsHostedVoicemailPolicy
トピックの最終更新日: 2012-03-23
ホスト ボイスメール ポリシーを取得します。
構文
Get-CsHostedVoicemailPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsHostedVoicemailPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
このコマンドレットを実行すると、不在時着信の Exchange ユニファイド メッセージング (UM) ホスト サービスへのルーティング方法を指定するポリシーが取得されます。
このポリシーを有効にするには、Exchange UM のホスト ボイスメールに対してユーザーを有効にする必要があります。ホスト ボイスメール ポリシーに対してユーザーが有効になっているかどうかを判別するには、Get-CsUser コマンドレットを呼び出して、HostedVoiceMail プロパティをチェックします (値が True であれば、ユーザーが有効になっていることを意味します)。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Get-CsHostedVoicemailPolicy コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsHostedVoicemailPolicy"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
取得するホスト ボイスメール ポリシーの一意の識別子です。この ID には、スコープ (グローバルの場合)、スコープとサイト (サイト ポリシーの場合。たとえば site:Redmond)、またはポリシー名 (ユーザーごとのポリシーの場合。たとえば HVUserPolicy) が含まれます。 |
Filter |
省略可能 |
文字列 |
このパラメーターを使用すると、ホスト ボイスメール ポリシーの ID をワイルドカード検索できます。この検索を実行すると、フィルター値で指定したワイルドカード パターンと一致する ID を持つホスト ボイスメール ポリシーのインスタンスがすべて取得されます。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア自体からではなく、中央管理ストアのローカル レプリカからホスト ボイス メール ポリシーを取得します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 型のオブジェクトが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsHostedVoicemailPolicy
このコマンドを実行すると、Microsoft Lync Server 2010 の実装で定義されているホスト ボイス メール ポリシーがすべて戻されます。
-------------------------- 例 2 --------------------------
Get-CsHostedVoicemailPolicy -Identity ExRedmond
このコマンドを実行すると、ExRedmond というユーザーごとのホスト ボイスメール ポリシーのポリシー設定が戻されます。
-------------------------- 例 3 --------------------------
Get-CsHostedVoicemailPolicy -Filter tag:*
このコマンドを実行すると、(先頭にタグ スコープが付く) すべてのユーザーごとのホスト ボイスメール ポリシーのポリシー設定が戻されます。