Get-CsUnassignedNumber
トピックの最終更新日: 2012-03-23
割り当てられていない番号の 1 つ以上の範囲とその番号に適用するルーティング ルールを取得します。
構文
Get-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsUnassignedNumber [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
割り当てられていない番号とは、組織に割り当てられている電話番号のうち、特定のユーザーまたは電話機にまだ割り当てられていない電話番号のことを言います。Microsoft Lync Server 2010 は、割り当てられていない番号が呼び出された場合に、その呼び出しを適切な宛先へ転送するよう設定することができます。このコマンドレットでは、このようなルーティングを定義する 1 つ以上の番号の範囲を取得します。
このコマンドレットを実行できるユーザー: 既定では、Get-CsUnassignedNumber コマンドレットをローカルで実行する権限があるのは、RTCUniversalUserAdmins、RTCUniversalServerAdmins、および RTCUniversalReadOnlyAdmin グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUnassignedNumber"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得する割り当てられていない番号の範囲を表す一意の名前です。 |
Filter |
省略可能 |
文字列 |
ワイルドカード検索を実行して、特定のワイルドカード文字列に一致する ID を持った割り当てられていない番号の設定のみに結果を絞り込むことができます。 |
LocalStore |
省略可能 |
SwitchParameter |
割り当てられていない番号の情報を、中央管理ストア 本体からではなく、中央管理ストア のローカル レプリカから取得します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange 型のオブジェクトを戻します。
例
-------------------------- 例 1 --------------------------
Get-CsUnassignedNumber
例 1 では、組織で使用するよう構成されているすべての割り当てられていない番号のコレクションを戻しています。
-------------------------- 例 2 --------------------------
Get-CsUnassignedNumber -Identity UNSet1
例 2 では、Identity パラメーターを使用して、取得されたデータを UNSet1 という ID を持つ割り当てられていない番号に制限しています。ID は一意である必要があるため、このコマンドは指定された割り当てられていない番号の範囲のみを戻します。
-------------------------- 例 3 --------------------------
Get-CsUnassignedNumber -Filter *Redmond*
この例では、Filter パラメーターを使用して、文字列 Redmond を含む ID 値を持つすべての割り当てられていない番号の設定のコレクションを戻しています。たとえば、このコマンドは、ID が Redmond Numbers、Unassigned Redmond Numbers、UNRedmond などである、割り当てられていない番号の設定を戻します。
-------------------------- 例 4 --------------------------
Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"}
例 4 では、Get-CsUnassignedNumber と Where-Object を使用して、アナウンスの名前に Welcome という単語が含まれる、すべての割り当てられていない番号の設定のコレクションを取得しています。これを行うため、まず Get-CsUnassignedNumber を使用して、割り当てられていない番号の設定をすべて取得します。次に、このコレクションを Where-Object にパイプ処理してフィルターを適用し、割り当てられたアナウンスの名前に Welcome という単語が含まれている割り当てられていない番号のデータのみが戻るようにします。