Remove-CsVoicePolicy
トピックの最終更新日: 2012-03-24
指定の音声ポリシーを削除します。
構文
Remove-CsVoicePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
このコマンドレットを実行すると、既存の音声ポリシーが削除されます。音声ポリシーは、同時呼び出し (会社の電話への着信時に 2 番目の電話を呼び出す機能) や自動転送などの、エンタープライズ VoIP 関連機能の管理に使用されます。このコマンドレットを使用して、グローバル音声ポリシーを削除することもできます。ただしこの場合、ポリシーが実際に削除されるのではなく、ポリシー設定が既定値にリセットされるだけです。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsVoicePolicy コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoicePolicy"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
XdsIdentity |
削除するポリシーのスコープ (および場合によっては名前) を指定する一意の識別子です。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy オブジェクト。音声ポリシー オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy オブジェクトのインスタンスを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsVoicePolicy -Identity UserVoicePolicy1
この例では、UserVoicePolicy1 というユーザーごとの音声ポリシー設定を削除しています。
-------------------------- 例 2 --------------------------
Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy
この例では、特定のユーザーに割り当て可能な音声ポリシー設定をすべて削除しています。まず、tag* のフィルターで Get-CsVoicePolicy コマンドレットを呼び出し、ユーザーごとのポリシーをすべて取得しています。次に、削除するポリシーのコレクションを Remove-CsVoicePolicy コマンドレットにパイプ処理しています。