New-CsVoicePolicy

構文

New-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>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

解説

このコマンドレットは、新しい音声ポリシーを作成します。音声ポリシーは、同時呼び出し (会社の電話への着信時に 2 番目の電話を呼び出す機能) や自動転送などの、エンタープライズ VoIP 関連機能の管理に使用されます。このコマンドレットで作成したポリシーによって、これらの機能の多くを有効にするか無効にするかが決定されます。

このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、New-CsVoicePolicy コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoicePolicy"}

パラメーター

入力の種類

なし。

戻り値の種類

このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy オブジェクトの 1 つのインスタンスが作成されます。

例

-------------------------- 例 1 --------------------------

New-CsVoicePolicy -Identity UserVoicePolicy1

この例では、Identity を UserVoicePolicy1 にして、既定の設定でユーザーごとの新しい音声ポリシーを作成します。

-------------------------- 例 2 --------------------------

New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}

この例では、Identity を UserVoicePolicy2 にしてユーザーごとの新しい音声ポリシーを作成し、AllowSimulRing プロパティを False に設定します。この設定により、このポリシーが割り当てられるすべてのユーザーで、同時呼び出し (会社の電話への着信時に毎回携帯電話などの 2 番目の電話を呼び出すかどうかを決定する機能) は有効にはなりません。このコマンドにより PSTN 使用法の一覧に "Local" も追加され、これによりこの音声ポリシーは Local PSTN 使用法も使用するボイス ルートと関連付けられます(Identity パラメーターが明示的に指定されていないことに注意してください。Identity パラメーターは位置パラメーターであるため、最初に ID 値をパラメーター一覧の最初に設定しておけば、それが ID であるということを明示する必要はありません)。

-------------------------- 例 3 --------------------------

$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}

この例では、Redmond サイトの新しい音声ポリシーを作成し、組織で定義されているすべての PSTN 使用法をこのポリシーに適用します。この例の 1 行目では、Get-CsPstnUsage コマンドレットを呼び出して組織の PSTN 使用法のグローバル セットを取得し、それを変数 $a に格納します。2 行目では、New-CsVoicePolicy を呼び出して Redmond サイトの新しい音声ポリシーを作成します。値が PstnUsages パラメーターに渡され、PSTN 使用法のグローバル セットに含まれている一覧がこのポリシーに追加されます。追加する値の構文は $a.Usage です。この構文を使用して、(PSTN 使用法の一覧が含まれた) PSTN 使用法の設定の Usage プロパティを参照しています。

関連項目

その他のリソース

Remove-CsVoicePolicy
Set-CsVoicePolicy
Get-CsVoicePolicy
Grant-CsVoicePolicy
Test-CsVoicePolicy
Get-CsPstnUsage