はじめに
このドキュメントでは、アプリケーション ユーザに関連付けられているデバイス情報を取得するために CLI で実行できる Structured Query Language(SQL)クエリについて説明します。
前提条件
要件
このドキュメントの読者は Cisco Unified Communications Manager(CUCM)に関する知識を持っていることを推奨します。
使用するコンポーネント
このドキュメントの情報は、CUCM バージョン 8.X 以降に基づいていますが、以前のバージョンでも同様に機能する場合もあります。
テーブル
SQL クエリは、次のテーブルのデータを使用して形成されます。
- Device:このテーブルには、デバイス レベルの情報(IP フォン、ゲートウェイなど)が含まれます。
- NumPlan:このテーブルには CUCM で設定されているすべてのパターンについての情報が含まれます。
- DeviceNumPlanMap:このテーブルには、Device テーブルと NumPlan テーブルのデータ間のマッピングが含まれます。
- RoutePartition:このテーブルには、CUCM で設定されているすべてのパーティションについての情報が含まれます。
- ApplicationUser:このテーブルには、アプリケーション ユーザに関する情報が含まれます。
- ApplicationUserDeviceMap:このテーブルには、ApplicationUser テーブルと Device テーブルのデータ間のマッピングが含まれます。
- DirGroup:このテーブルには、権限グループに関する情報が含まれます。
- ApplicationUserDirGroupMap:このテーブルには、ApplicationUser テーブルと DirGroup テーブルのデータ間のマッピングが含まれます。
これらのテーブルの詳細については、該当するバージョンの『CUCM Data Dictionary』を参照してください。
SQL クエリ
簡単に把握できるようにするため、クエリは一度に 1 つの関連付けを検出するように記述されています。
アプリケーション ユーザとデバイス関連付けの一覧表示
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join device as d on d.pkid=audm.fkdevice order by au.name
admin:run sql select au.name as ApplicationUser, d.name as Device, d.description
as DeviceDescription from applicationuser as au inner join
applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard
='f' inner join device as d on d.pkid=audm.fkdevice order by au.name
applicationuser device devicedescription
=============== =============== ============================
Test1 SEP503DE57D7DAC 8501
Test1 SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212
Test2 CTI1 CTI1
このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用しているため削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」(false)を「t」(true)に変更します。
この例では、2 つのアプリケーション ユーザが示されています。
- Test 1 は 2 台の電話機に関連付けられています。
- Test 2 は、コンピュータ テレフォニー インテグレーション(CTI)ルート ポイントに関連付けられています。
注:必要な情報のみを含むように、任意のフィールドをフィルタリングできます。たとえば、デバイスをフィルタリングするには:デバイス名がSEPで始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前にwhere d.name like 'SEP%を追加します。フォーマットは where <column name> like '<value>%' です。
アプリケーション ユーザ、権限、およびデバイス関連付けの一覧表示
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, dg.name as PermissionGroup from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join ApplicationUserDirGroupMap as audgm on audgm.fkapplicationuser=au.pkid inner join DirGroup as dg on audgm.fkdirgroup=dg.pkid inner join device as d on d.pkid=audm.fkdevice order by au.name
applicationuser device devicedescription permissiongroup
=============== =============== ============================ =========================================
Test1 SEP503DE57D7DAC 8501 Standard CCM Admin Users
Test1 SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 Standard CCM Admin Users
Test2 CTI1 CTI1 Standard CTI Allow Control of All Devices
Test2 CTI1 CTI1 Standard CTI Enabled
このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用して削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」(false)を「t」(true)に変更します。
注:必要な情報のみを含むように、任意のフィールドをフィルタリングできます。たとえば、デバイスをフィルタリングするには:デバイス名がSEPで始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前にwhere d.name like 'SEP%'を追加します。フォーマットは where <column name> like '<value>%' です。
アプリケーション ユーザ、デバイス、およびデバイス関連情報の一覧表示
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, rp.name as partition, dp.name as DevicePool from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid inner join routepartition as rp on np.fkroutepartition=rp.pkid order by au.name
applicationuser device devicedescription dn partition devicepool
=============== =============== ============================ ==== =========== ==========
Test1 SEP503DE57D7DAC 8501 8501 Internal_PT HQ
Test1 SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1213 Internal_PT HQ
Test1 SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1212 Internal_PT HQ
Test2 CTI1 CTI1 1945 Internal_PT HQ
このクエリは、関連デバイスの識別名(DN)がパーティション内にある場合は、アプリケーション ユーザを一覧表示しません。None パーティションにあるものを含めるには、次のようにします。
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, dp.name as DevicePool from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid order by au.name.
このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用して削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」(false)を「t」(true)に変更します。
注:必要な情報のみを含むように、任意のフィールドをフィルタリングできます。たとえば DN でフィルタリングするには、クエリの末尾、「order by au.name」の直前に where np.dnorpattern like '8%' を追加します。これは、8 で始まる DN があるすべてのエントリを表示します。フォーマットは where <column name> like '<value>%' です。デバイスでフィルタリングを行うには、デバイス名がSEPで始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前にwhere d.name like 'SEP%'を追加します。
アプリケーション ユーザ、権限、およびデバイス関連情報の一覧表示
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, rp.name as partition, dp.name as DevicePool, dg.name as PermissionGroup from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join ApplicationUserDirGroupMap as audgm on audgm.fkapplicationuser=au.pkid inner join DirGroup as dg on audgm.fkdirgroup=dg.pkid inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid inner join routepartition as rp on np.fkroutepartition=rp.pkid order by au.name
applicationuser device devicedescription dn partition devicepool permissiongroup
=============== =============== ============================ ==== =========== ========== =========================================
Test1 SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1213 Internal_PT HQ Standard CCM Admin Users
Test1 SEP503DE57D7DAC 8501 8501 Internal_PT HQ Standard CCM Admin Users
Test1 SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1212 Internal_PT HQ Standard CCM Admin Users
Test2 CTI1 CTI1 1945 Internal_PT HQ Standard CTI Allow Control of All Devices
Test2 CTI1 CTI1 1945 Internal_PT HQ Standard CTI Enabled
このクエリは、関連デバイスの DN がパーティション内にある場合は、アプリケーション ユーザを一覧表示しません。None パーティションにあるものを含めるには、次のようにします。
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, dp.name as DevicePool, dg.name as PermissionGroup from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join ApplicationUserDirGroupMap as audgm on audgm.fkapplicationuser=au.pkid inner join DirGroup as dg on audgm.fkdirgroup=dg.pkid inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid order by au.name
このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用して削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」(false)を「t」(true)に変更します。
注:必要な情報のみを含むように、任意のフィールドをフィルタリングできます。たとえば DN でフィルタリングするには、クエリの末尾、「order by au.name」の直前に where np.dnorpattern like '8%' を追加します。これは、8 で始まる DN があるすべてのエントリを一覧表示します。フォーマットは where <column name> like '<value>%' です。デバイスでフィルタリングを行うには、次のようにします。デバイス名がSEPで始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前にwhere d.name like 'SEP%を追加します。
権限グループの権限ロールの一覧表示
run sql select dg.name as PermissionGroup, fr.name as PermissionRole from DirGroup as dg inner join functionroledirgroupmap as frdgm on frdgm.fkdirgroup=dg.pkid inner join functionrole as fr on frdgm.fkfunctionrole=fr.pkid
permissiongroup permissionrole
======================================================================= =======================================================================
Standard CCM Super Users Standard CCMADMIN Administration
Standard CCM Super Users Standard SERVICEABILITY Administration
Standard CCM Super Users Standard CCM Admin Users
Standard CCM Super Users Standard Admin Rep Tool Admin
Standard CCM Super Users Standard AXL API Access
Standard CCM Super Users Standard EM Authentication Proxy Rights
Standard CCM Super Users Standard CUReporting
Standard CCM Admin Users Standard CCM Admin Users
Standard CCM Admin Users Standard CUReporting
Standard CCM Read Only Standard CCMADMIN Read Only
Standard CCM Read Only Standard CCM Admin Users
Standard CCM Read Only Standard SERVICEABILITY Read Only
Standard CCM Server Monitoring Standard CCMADMIN Read Only
Standard CCM Server Monitoring Standard SERVICEABILITY
Standard CCM Server Monitoring Standard CCM Admin Users
Standard CCM Server Maintenance Standard CCMADMIN Read Only
Standard CCM Server Maintenance Standard CCM System Management
Standard CCM Server Maintenance Standard CCM Feature Management
Standard CCM Server Maintenance Standard CCM Service Management
Standard CCM Server Maintenance Standard System Service Management
Standard CCM Server Maintenance Standard CCM Admin Users
Standard CCM Phone Administration Standard CCMADMIN Read Only
Standard CCM Phone Administration Standard CCM Phone Management
Standard CCM Phone Administration Standard CCM Admin Users
Standard CCM Gateway Administration Standard CCMADMIN Read Only
Standard CCM Gateway Administration Standard CCM Gateway Management
Standard CCM Gateway Administration Standard CCM Admin Users
Standard CTI Enabled Standard CTI Enabled
Standard CTI Allow Calling Number Modification Standard CTI Allow Calling Number Modification
Standard CTI Allow Call Park Monitoring Standard CTI Allow Call Park Monitoring
Standard CTI Allow Control of All Devices Standard CTI Allow Control of All Devices
Standard CAR Admin Users Standard Admin Rep Tool Admin
Standard EM Authentication Proxy Rights Standard EM Authentication Proxy Rights
Standard CCM End Users Standard CCM End Users
Standard CCM End Users Standard CCMUSER Administration
Standard Packet Sniffer Users Standard Packet Sniffing
Standard Packet Sniffer Users Standard CCM Admin Users
Standard CTI Secure Connection Standard CTI Secure Connection
Standard CTI Allow Reception of SRTP Key Material Standard CTI Allow Reception of SRTP Key Material
Standard TabSync User Standard AXL API Access
Standard CTI Allow Call Monitoring Standard CTI Allow Call Monitoring
Standard CTI Allow Call Recording Standard CTI Allow Call Recording
Standard RealtimeAndTraceCollection Standard RealtimeAndTraceCollection
Standard Audit Users Standard Audit Log Administration
Standard CTI Allow Control of Phones supporting Connected Xfer and conf Standard CTI Allow Control of Phones supporting Connected Xfer and conf
Standard CTI Allow Control of Phones supporting Rollover Mode Standard CTI Allow Control of Phones supporting Rollover Mode
AXL_User Standard AXL API Access