Get-CsDialPlan
トピックの最終更新日: 2012-03-23
組織で使用されるダイヤル プランに関する情報を戻します。
構文
Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
このコマンドレットは、組織の 1 つ以上のダイヤル プラン (ロケーション プロファイルとも言います) に関する情報を戻します。ダイヤル プランは、エンタープライズ VoIP ユーザーが通話をするのに必要な情報を提供します。ダイヤル プランは、電話会議アテンダント アプリケーション でのダイヤルイン会議にも使用されます。ダイヤル プランによって、適用する正規化ルールや、外線発信の際にプレフィックスをダイヤルする必要があるかどうかなどが決定されます。
注: Get-CsDialPlan を使用すると、ダイヤル プランの正規化ルールに関する特定の情報を取得できますが、ダイヤル プランの情報のうち正規化ルールに関するもののみが必要な場合は、Get-CsVoiceNormalizationRule コマンドレットを使用することもできます。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Get-CsDialPlan コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialPlan"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
取得するダイヤル プランを識別するためのスコープ (ユーザーごとのスコープの場合は名前) を指定する一意の識別子です。 |
Filter |
省略可能 |
文字列 |
ワイルドカード検索を実行して、特定のワイルドカード文字列に一致する Identitiy を持ったダイヤル プランのみに結果を絞り込むことができます。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからダイヤル プラン情報を取得します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsDialPlan
例 1 では、組織で使用するために構成されたすべてのダイヤル プランのコレクションを戻します。これを行うため、追加パラメーターなしで Get-CsDialPlan を呼び出します。
-------------------------- 例 2 --------------------------
Get-CsDialPlan -Identity RedmondDialPlan
例 2 では Identity パラメーターを使用して、取得するデータを制限します。RedmondDialPlan という ID のユーザーごとのダイヤル プランを持つダイヤル プランのみを取得します。ID は一意である必要があるため、このコマンドは指定されたダイヤル プランのみを戻します。
-------------------------- 例 3 --------------------------
Get-CsDialPlan -Identity site:Redmond
例 3 は例 2 に似ていますが、ユーザーごとのダイヤル プランを取得する代わりに、サイトに対して割り当てられたダイヤル プランを取得します。これを実行するために、site: という値を指定し、その後に取得しようとするサイトのサイト名 (この例では Redmond) を続けます。
-------------------------- 例 4 --------------------------
Get-CsDialPlan -Filter tag:*
この例では Filter パラメーターを使用して、ユーザーごとのスコープで構成されたすべてのダイヤル プランのコレクションを戻します。(ユーザーごとまたはタグのスコープで構成された設定は、直接ユーザーとグループに割り当てることができます。)ワイルドカード文字列 tag:* により、文字列値 tag: で始まる Identity を持つダイヤル プランのみを戻すように指示します。tag: により、ダイヤル プランはユーザーごとのダイヤル プランとして識別されます。
-------------------------- 例 5 --------------------------
Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules
この例では、組織で使用するために構成されたダイヤル プランで用いる正規化ルールを表示します。NormalizationRules プロパティはオブジェクトの配列からなるため、正規化ルールの完全なセットは通常、画面に表示されません。これらのルールをすべて表示するため、このサンプル コマンドではまず、Get-CsDialPlan を使用して、すべてのダイヤル プランのコレクションを取得します。次に、このコレクションは Select-Object コマンドレットにパイプ処理されます。その後、Select-Object の ExpandProperty パラメーターを使用し、NormalizationRules プロパティの中で見つかった値を "展開" します。値の展開とは単純に、すべての正規化ルールが画面に表示されることを意味します。Get-CsVoiceNormalizationRule を呼び出した場合も、同じ出力が得られます。
-------------------------- 例 6 --------------------------
Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}
例 6 では、Get-CsDialPlan と Where-Object を使用して、説明に Redmond という語を含んだすべてのダイヤル プランのコレクションを取得します。この処理を行うには、まず、Get-CsDialPlan を使用して、すべてのダイヤル プランを取得します。次に、このコレクションは Where-Object にパイプ処理され、Where-Object により、返りデータを制限して説明に Redmond という語を含むプロファイルのみにするフィルターが適用されます。