New-CsHostedVoicemailPolicy
トピックの最終更新日: 2012-03-25
新しいホスト ボイス メール ポリシーを作成します。
構文
New-CsHostedVoicemailPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
解説
このコマンドレットを実行すると、Exchange ユニファイド メッセージング (UM) のホスト ボイス メール サービスを使用する、Microsoft Lync Server 2010 または Office Communications Server が有効なユーザー アカウントを構成するポリシーが作成されます。このポリシーは、ユーザー不在時の着信をホスト Exchange UM サービスにルーティングする方法を決定します。
このポリシーを有効にするには、Exchange UM のホスト ボイス メールに対してユーザーを有効にする必要があります。ホスト ボイス メール ポリシーに対してユーザーが有効になっているかどうかを判別するには、Get-CsUser コマンドレットを呼び出して、HostedVoiceMail プロパティをチェックします(値が True であれば、ユーザーが有効になっていることを意味します)。
サイト スコープで作成したポリシーは、そのサイトに所属するユーザーに自動的に割り当てられます。ユーザーごとのスコープで作成されたポリシーは、Grant-CsHostedVoicemailPolicy コマンドレットを使用して、ユーザー オブジェクトや連絡先オブジェクトに割り当てる必要があります。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが New-CsHostedVoicemailPolicy コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsHostedVoicemailPolicy"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
スコープおよびサイト (サイト ポリシーの場合は site:Redmond など)、またはポリシー名 (ユーザーごとのポリシーの場合は RenoHostedVoicemail など) などの、ポリシーの一意の識別子。グローバル ポリシーは常に存在し、削除できないため、グローバル ポリシーを作成することはできません。 |
Description |
省略可能 |
文字列 |
ポリシーの簡単な説明です。 |
Destination |
省略可能 |
文字列 |
このパラメーターに割り当てられる値は、ホスト Exchange UM サービスの完全修飾ドメイン名 (FQDN) です。 このパラメーターは省略可能ですが、ユーザーに割り当てられているポリシーで送信先の値が設定されていないと、ユーザーのホスト ボイス メールを有効にしようとしても失敗します。 この値は、255 文字以内で、server.litwareinc.com などの FQDN 形式にする必要があります。 |
Organization |
省略可能 |
文字列 |
このパラメーターには、Lync Server 2010 ユーザーを含んだ Exchange テナントのコンマ区切り一覧があります。各テナントは、ホスト Exchange サービス上のテナントの FQDN として指定する必要があります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
InMemory |
省略可能 |
SwitchParameter |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 型のオブジェクトが作成されます。
例
-------------------------- 例 1 --------------------------
New-CsHostedVoicemailPolicy -Identity ExRedmond -Destination ExUM.fabrikam.com -Description "Hosted voicemail policy for Redmond users." -Organization "corp1.litwareinc.com, corp2.litwareinc.com"
このコマンドは、ExRedmond という名前の新しいホスト ボイス メール ポリシーを作成します(スコープが指定されていないため、このポリシーは個別のユーザーや連絡先に割り当てることができます)。このポリシーでは、その Exchange UM 宛先が FQDN ExUM.fabrikam.com と定義されています。また、このポリシーの Lync Server 2010 ユーザーを litwareinc の corp1 および corp2 という組織に分散させることができます。このポリシーは、(Description パラメーター値で) "Redmond ユーザーのホスト ボイス メール プロパティ" と表示されます。