Set-CsDialPlan
トピックの最終更新日: 2012-03-27
既存のダイヤル プランを変更します。
構文
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
解説
このコマンドレットは、既存のダイヤル プラン (別名ロケーション プロファイル) を変更します。ダイヤル プランは、エンタープライズ VoIP ユーザーが通話をするのに必要な情報を提供します。ダイヤル プランは、電話会議アテンダント アプリケーション でのダイヤルイン会議にも使用されます。ダイヤル プランによって、適用する正規化ルールや、外線発信の際にプレフィックスをダイヤルする必要があるかどうかなどが決定されます。
注: このコマンドレットを使用してダイヤル プランの正規化ルールを変更できますが、代わりに New-CsVoiceNormalizationRule、Set-CsVoiceNormalizationRule、または Remove-CsVoiceNormalizationRule コマンドレットを使用することをお勧めします。これらのコマンドレットを使用して加えられた変更は、対応するダイヤル プランに反映されます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Set-CsDialPlan コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialPlan"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
スコープまたはユーザーごとのプラン、名前を指定して、変更するダイヤル プランを識別するための一意の識別子。たとえば、サイトの Identity は site:<sitename> の形式となります。ここで、sitename はサイトの名前です。サービス スコープでのダイヤル プランは、レジストラーまたは PSTN ゲートウェイ サービスです。Identity 値の形式は、Registrar:Redmond.litwareinc.com のようになります。ユーザーごとの Identity は一意の文字列値です。 |
Instance |
省略可能 |
場所のプロファイル |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。このオブジェクト参照は、Get-CsDialPlan コマンドレットを呼び出すことで取得できます。 |
Description |
省略可能 |
文字列 |
このダイヤル プランの説明 (目的、適用対象のユーザー タイプ、その他のダイヤル プランの目的の識別に役立つ情報)。 最大文字数: 512 |
DialinConferencingRegion |
省略可能 |
文字列 |
このダイヤル プランに関連付けられている地域名。ダイヤル プランをダイヤルイン会議で使用する場合は、このパラメーターの値を指定します。これにより会議開催者は、会議を設定するときに正しいアクセス番号を割り当てることができます。使用可能な地域は Get-CsNetworkRegion コマンドレットを呼び出すことで取得できます。 最大文字数: 512 |
ExternalAccessPrefix |
省略可能 |
文字列 |
組織に対して、呼び出しを外線として認識する番号 (または番号セット)。(たとえば外線にダイヤルするには、最初に 9 を押します。)これらのルールは残りの番号にも適用されますが、このプレフィックスは正規化ルールでは無視されます。 この値を有効にするには、OptimizeDeviceDialing パラメーターを True に設定する必要があります。 このパラメーターの値は、正規表現 [0-9]{1,4} と一致する必要があります。つまり、値の桁数が 1 ～ 4 桁で、各桁の数字が 0 ～ 9 になっている必要があります。 |
NormalizationRules |
省略可能 |
PSListModifier |
このダイヤル プランに適用される正規化ルールの一覧。 この一覧とルールはこのコマンドレットを使用して直接変更できますが、正規化ルールを作成する際には、New-CsVoiceNormalizationRule コマンドレットを使用してルールを作成し、それを指定のダイヤル プランに割り当て、Set-CsVoiceNormalizationRule コマンドレットでそれらのルールを変更するという方法を取ることをお勧めします。 |
OptimizeDeviceDialing |
省略可能 |
ブール値 |
このパラメーターを True に設定すると、組織外部からの呼び出しに対して ExternalAccessPrefix パラメーターのプレフィックスが適用されます。この値は、ExternalAccessPrefix パラメーターに値が指定されている場合にのみ、True に設定できます。 |
SimpleName |
省略可能 |
文字列 |
ダイヤル プランのフレンドリ名。ダイヤル プラン名は、Microsoft Lync Server 2010 の展開内のすべてのダイヤル プランの中で一意である必要があります。 この文字列には最大 256 文字を使用できます。有効な文字は英数字、ハイフン (-)、ドット (.)、正符号 (+)、アンダースコア (_)、およびかっこ (()) です。 |
State |
省略可能 |
文字列 |
このコマンドレットでは、このパラメーターを使用しません。 |
City |
省略可能 |
文字列 |
このコマンドレットでは、このパラメーターを使用しません。 |
CountryCode |
省略可能 |
文字列 |
このコマンドレットでは、このパラメーターを使用しません。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前の確認メッセージが表示されないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile オブジェクト。パイプライン処理されたダイヤル プラン オブジェクトの入力を受け入れます。
戻り値の種類
Set-CsDialPlan は、値またはブジェクトを戻しません。代わりに、このコマンドレットは、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
例 1 では、Set-CsDialPlan を使用して RedmondDialPlan という Identity を持つダイヤル プランを変更します。この場合は、変更されるプロパティは Description のみです。この変更は、Description パラメーターの後に新しい説明のテキストを指定することで実行されます。
-------------------------- 例 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
この例では、Set-CsDialPlan を使用して、組織で使用するために構成されているすべてのダイヤル プランの ExternalAccessPrefix プロパティの値を変更しています。このタスクを実行するには、まず Get-CsDialPlan を使用して、組織内のすべてのダイヤル プランのコレクションを戻します。次に、このコレクションを Set-CsDialPlan にパイプ処理し、その結果、コレクション内の各プロファイルの ExternalAccessPrefix プロパティに 8 の値を割り当てます。