Set-CsVoicePolicy
トピックの最終更新日: 2012-03-27
既存の音声ポリシーを変更します。
構文
Set-CsVoicePolicy [-Identity <XdsIdentity>] [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsVoicePolicy [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]
解説
このコマンドレットは、既存の音声ポリシーを変更します。音声ポリシーは、同時呼び出し (会社の電話への着信時に 2 番目の電話を呼び出す機能) や自動転送などの、エンタープライズ VoIP 関連機能の管理に使用されます。このコマンドレットを使用して、多くのエンタープライズ VoIP 関連機能を有効および無効にする設定を変更します。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーは Set-CsVoicePolicy コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoicePolicy"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
ポリシーのスコープ (および場合によっては名前) を指定する一意の識別子です。 |
Instance |
省略可能 |
VoicePolicy |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 このオブジェクトは VoicePolicy 型である必要があり、Get-CsVoicePolicy コマンドレットを呼び出すことで取得できます。 |
AllowCallForwarding |
省略可能 |
ブール値 |
このパラメーターを True に設定すると、このポリシーに割り当てられたユーザーが呼び出しを転送できます。このパラメーターが False に設定されていると、呼び出しを転送できません。 |
AllowPSTNReRouting |
省略可能 |
ブール値 |
このパラメーターを True に設定すると、別のプールに所属する内部番号に呼び出しがあった際にそのプールまたは WAN を使用できない場合、公衆交換電話網 (PSTN) を使ってルーティングします。 |
AllowSimulRing |
省略可能 |
ブール値 |
同時呼び出しは、1 つの番号がダイヤルされた際に複数の電話を呼び出せるようにする機能です。このパラメーターを True に設定すると、同時呼び出しが有効となります。このパラメーターが False に設定されていると、このポリシーに割り当てられているユーザーで同時呼び出しを構成することはできません。 |
Description |
省略可能 |
文字列 |
音声ポリシーの説明です。 最大長: 1040 文字 |
EnableBWPolicyOverride |
省略可能 |
ブール値 |
帯域幅を制限するようにポリシーを設定できます。また、ネットワーク構成に関する他の各種プロパティを設定できます。このパラメーターを True に設定すると、これらのポリシーが優先されます。つまり、このパラメーターを True に設定すると帯域幅の確認は行われず、呼び出しは通話受付管理 (CAC) 設定に関係なく処理されます。 |
EnableCallPark |
省略可能 |
ブール値 |
コール パーク アプリケーション を使用すると、さまざまな番号の中の特定の番号で呼び出しを保留 (パーク) しておき、後で受けることができます。このパラメーターを True に設定すると、このポリシーに割り当てられているユーザーに対してこのアプリケーションが有効になります。このパラメーターを False に設定すると、このポリシーに割り当てられているユーザーは、自分の電話番号への呼び出しを保留することができません。 |
EnableCallTransfer |
省略可能 |
ブール値 |
呼び出しを別の番号に転送できるかどうかを決定します。このパラメーターを True に設定すると呼び出しを転送することができ、False に設定すると転送することができません。 |
EnableDelegation |
省略可能 |
ブール値 |
ユーザーが代理呼び出しを使用して、他のユーザーの代わりに通話に応答したり、電話をかけたりできます。たとえば、代理呼び出しによって、マネージャーは、すべての着信が自分と秘書の両方の電話に着信するよう設定することができます。このパラメーターを True に設定すると、このポリシーの対象ユーザーは代理呼び出しを設定できます。このパラメーターを False に設定すると、代理呼び出しが無効となります。 |
EnableMaliciousCallTracing |
省略可能 |
ブール値 |
悪意のある呼び出しのトレースは、悪意があると指定した呼び出しをトレースするための標準機能です。このような呼び出しは発信者 ID がブロックされていてもトレースできます。トレースを使用できるのは適切な機関のみであり、ユーザーは使用できません。このプロパティを True に設定すると、悪意のある呼び出しのトレース設定が有効となります。 |
EnableTeamCall |
省略可能 |
ブール値 |
チーム呼び出しを使用すると、あるユーザーの番号の呼び出し時に着信するユーザーのグループを指定できます。この機能は、顧客からの着信に対してチームの全員が応答できるようにする場合などに便利です。このパラメーターを True に設定すると、この機能が有効となります。 |
Name |
省略可能 |
文字列 |
このポリシーを説明するフレンドリ名です。 |
PreventPSTNTollBypass |
省略可能 |
ブール値 |
PSTN 料は、一般に長距離通話料として知られています。ブランチ オフィス間でネットワーク経由の通話が可能なボイス オーバー IP (VoIP) を導入して、この料金がかからないようにしている組織もあります。このパラメーターを True に設定すると、無料のネットワーク経由でなく、有料の PSTN 経由で呼び出しが行われます。 |
PstnUsages |
省略可能 |
PSListModifier |
このポリシーで使用できる PSTN 使用法の一覧です。PSTN 使用法によって音声ポリシーと電話ルートを関連付けます。 この一覧には任意の文字列値を指定できますが、その値が現在の PSTN 使用法のグローバル一覧に存在している必要があります (重複する文字列は許可されません。すべての文字列は一意である必要があります)。PSTN 使用法の一覧は、Get-CsPstnUsage コマンドレットを呼び出すことで取得できます。 このパラメーターを使用してすべての PSTN 使用法をポリシーから削除する場合は、このポリシーが付与されているユーザーが PSTN 通話を発信できなくなる点に留意してください。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy オブジェクト。音声ポリシー オブジェクトのパイプ処理された入力を受け入れます。
戻り値の種類
このコマンドレットは、値またはオブジェクトを戻しません。代わりに、Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 --------------------------
Set-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{remove="Local"}
この例では、ユーザーごとのポリシー UserVoicePolicy2 の AllowSimulRing プロパティを False に設定しています。つまり、このポリシーを割り当てられたユーザーは、同時呼び出し (会社の電話への着信時に携帯電話などの 2 番目の電話を呼び出すかどうかを決定する機能) を使用できません。このコマンドはまた、このポリシーの PSTN 使用法の一覧から "Local" を削除します (Identity パラメーターが明示的に指定されていないことに注意してください。Identity パラメーターは位置パラメーターであるため、ID 値をパラメーター一覧の最初に設定しておけば、Identity であることを明示する必要はありません)。
-------------------------- 例 2 --------------------------
$a = Get-CsPstnUsage
Set-CsVoicePolicy -Identity site:Redmond -PstnUsages @{replace=$a.Usage}
この例では、サイト Redmond の音声ポリシーを変更して、組織で定義されたすべての PSTN 使用法がこのポリシーに適用されるようにしています。この例の最初の行で Get-CsPstnUsage コマンドレットを呼び出して、組織のグローバルな PSTN 使用法のセットを取得し、そのセットを変数 $a に保存します。2 行目では Set-CsVoicePolicy を呼び出し、サイト Redmond の音声ポリシーを変更します。値は PstnUsages パラメーターに渡され、ポリシーの現在の使用法の一覧を、グローバルな PSTN 使用法のセットに含まれた一覧に置き換えています。置換値の構文 $a.Usage。この構文を使用して、(PSTN 使用法の一覧が含まれた) PSTN 使用法の設定の Usage プロパティを参照しています。