Remove-CsHostedVoicemailPolicy
トピックの最終更新日: 2012-03-27
ホスト ボイスメール ポリシーを削除します。
構文
Remove-CsHostedVoicemailPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
このコマンドレットを実行すると、不在時着信の Exchange ユニファイド メッセージング (UM) ホスト サービスへのルーティング方法を指定するポリシーが削除されます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsHostedVoicemailPolicy コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsHostedVoicemailPolicy"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
削除するホスト ボイスメール ポリシーの一意の識別子です。この識別子には、スコープ (グローバルの場合)、(site:Redmond など、サイト ポリシーの) スコープとサイト、(HVUserPolicy など、ユーザーごとのポリシーの) ポリシー名などが含まれます。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy オブジェクト。ホスト ボイスメール ポリシー オブジェクトのパイプライン処理された入力を受け入付けます。
戻り値の種類
このコマンドレットを実行してもオブジェクトが戻されることはありません。Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 型のオブジェクトが削除されます。
例
-------------------------- 例 1 --------------------------
Remove-CsHostedVoicemailPolicy -Identity ExRedmond
このコマンドを実行すると、ExRedmond というユーザーごとのポリシーのホスト ボイスメール ポリシーが削除されます。
-------------------------- 例 2 --------------------------
Get-CsHostedVoicemailPolicy -Filter tag* | Remove-CsHostedVoicemailPolicy
例 2 のコマンドを実行すると、ユーザーごとのホスト ボイスメール ポリシーがすべて削除されます。このコマンドでは、まずタグ* のフィルターで Get-CsHostedVoicemailPolicy コマンドレットを呼び出し、ユーザーごとのポリシーとして定義されているポリシーをすべて取得しています。次に、ポリシーのセットを Remove-CsHostedVoicemailPolicy にパイプ処理し、1 つずつ削除しています。