サポートと今すぐチャット
サポートとのチャット

KACE Systems Management Appliance 13.2 Common Documents - Administrator Guide (Japanese - 13.0)

KACE システム管理アプライアンスについて
アプライアンスコンポーネントについて 管理者コンソールについて
組織コンポーネントが有効化されていない場合の管理者モードで使用可能なコンポーネント 組織コンポーネントが有効化されている場合の管理者モードで使用可能なコンポーネント 組織コンポーネントが有効化されている場合のシステムモードで使用可能なコンポーネント 「ホーム」コンポーネントの使用 情報の検索およびリストのフィルタリング 管理者コンソールへのログイン: 初めてネットワークを構成した後の最初のログイン
はじめに
アプライアンスの設定
要件と仕様 アプライアンスの電源投入と管理者コンソールへのログイン コマンドラインコンソールへのアクセス 設定の変更追跡 システムレベルおよび管理者レベルの一般設定項目の設定 アプライアンスの日付と時刻の設定 ユーザー通知の管理 すべてのユーザーに対して 2 要素認証を有効にする ポート設定、NTPサービス、およびWebサイトアクセスの検証 ネットワーク設定とセキュリティ設定の構成 エージェント設定の構成 セッションタイムアウトと自動更新設定の構成 ロケール設定の構成 デフォルトテーマの設定 データ共有の基本設定の構成 DIACAPコンプライアンス要件について モバイルデバイスによるアクセスの設定 組織およびリンク先アプライアンスの高速切り替えの有効化 Quest KACEアプライアンスのリンク 履歴設定の定義
アイテムのグループを管理するためのラベルのセットアップおよび使用 ユーザーアカウント、LDAP認証、およびSSOの設定
ユーザーアカウントおよびユーザー認証について ロケール設定について システムレベルユーザーアカウントの管理 組織ユーザーアカウントの管理 ユーザープロファイルの表示または編集 LDAPサーバーを使用したユーザー認証 LDAPサーバーからのユーザーのインポート シングルサインオン（SSO）について シングルサインオンの有効化および無効化 Active Directory を使用したシングルサインオン シングルサインオン用に SAML を構成する ユーザーセッションの確認
管理対象デバイスへの KACE エージェントの展開 レプリケーション共有の使用 資格情報の管理 資産の設定
資産管理コンポーネントについて 資産管理ダッシュボードの使用方法 資産管理について 資産タイプの追加とカスタマイズおよび資産情報の維持 ソフトウェア資産の管理 物理的資産と論理的資産の管理 手動資産情報の維持および使用 場所の管理 契約の管理 ライセンスの管理 購入レコードの管理
ライセンスコンプライアンスの設定 ライセンスコンプライアンスの管理 サービスデスクの設定 サービスデスクウィジェットのキャッシュライフタイムの設定 組織の作成と管理 アプライアンスリソースのインポートとエクスポート
インベントリの管理
インベントリダッシュボードの使用 デバイス検出の使用 デバイスインベントリの管理
デバイスの管理について 各デバイス管理方法で使用可能な機能 インベントリ情報について インベントリ設定に対する変更の追跡 インベントリ情報の管理 デバイスの検出および管理 アプライアンスへの KACE エージェントの登録 KACE エージェントのプロビジョニング
ファイル共有を有効にする Windows デバイスでの GPO プロビジョニングツールを使用した KACE エージェントのプロビジョニング オンボードプロビジョニングを使用した KACE エージェントのプロビジョニング プロビジョニングスケジュールの管理 エージェント通信の管理 管理対象デバイスでの KACE エージェントの更新
KACE エージェントを手動展開する
エージェントのインストールファイルの取得 Windows デバイス上で KACE エージェントを手動展開する Linux デバイスでの手動による KACE エージェントの展開およびアップグレード Linuxデバイス上でのエージェントに関する操作の実行 Mac デバイスでの手動による KACE エージェントの展開およびアップグレード Macデバイス上でエージェントに関するその他の操作を実行する エージェントによって収集された情報の表示
エージェント不要の管理の使用 管理者コンソールでの、または API を使用したデバイスの手動追加 インベントリ更新の強制実行 MIAデバイスの管理 Dell保証情報の取得
ソフトウェア ページでのアプリケーション管理
ソフトウェア ページについて インベントリ設定に対する変更の追跡 ソフトウェア ページインベントリ内のアプリケーションの追加と削除 ソフトウェア資産の作成 ソフトウェア脅威レベルとカテゴリの使用 アプリケーションの検索とラベル作成 ITNinjaフィードの管理
ソフトウェアカタログインベントリの管理
ソフトウェアカタログについて ソフトウェアカタログ情報の表示 ソフトウェアカタログへのアプリケーションの追加 ソフトウェアカタログのアプリケーションに関するライセンス資産の管理 管理対象インストールとカタログ登録済みソフトウェアの関連付け ソフトウェアメータリングの使用 アプリケーション制御の使用 ソフトウェアカタログの更新および再インストール
プロセス、スタートアッププログラム、およびサービスインベントリの管理 カスタムインベントリルールの記述
管理対象デバイスへのパッケージの展開
ソフトウェアの配布とWake On LANの使用
ソフトウェアの配布について 配布設定に対する変更の追跡 配布パッケージのタイプ アプライアンスからのパッケージの配布 代替のダウンロード場所およびレプリケーション共有からのパッケージの配布 Mac OS Xデバイスへのアプリケーションの配布 管理対象インストールの使用 ファイル同期の作成および使用 Wake On LANの使用 管理対象インストールのエクスポート
管理対象デバイスへの警告のブロードキャスト 管理対象デバイスでのスクリプトの実行
スクリプトについて スクリプト設定の変更追跡 デフォルトスクリプトについて スクリプトの追加と編集 実行 および 今すぐ実行 コマンドの使用 設定ポリシーテンプレートについて Windows設定ポリシーの使用 Mac OS X設定ポリシーの使用 ポリシーとスクリプトの編集 スクリプトログの検索 スクリプトのエクスポート
Mac プロファイルの管理 タスクチェーンの使用
デバイスのパッチ適用とセキュリティの維持
セキュリティダッシュボードの使用 パッチ管理について パッチのサブスクライブとダウンロード パッチスケジュールの作成および管理 パッチインベントリの管理 Windows 機能更新プログラムの管理 Dellデバイスおよびアップデートの管理 Linux パッケージアップグレードの管理 デバイスとアプライアンスのセキュリティの維持 隔離された添付ファイルを管理する
レポートの使用と通知のスケジュール サーバーの監視
サーバー監視の開始 監視プロファイルの操作 デバイスの監視の管理 警告の操作
サービスデスクの使用
サービスデスクの設定
システム要件 サービスデスクについて 設定作業の概要 別のシステムからのチケットのインポート サービスデスクの営業時間と休業日の設定 サービスレベル契約の設定 サービスデスクチケットキューの設定 チケット設定の構成 ユーザーコンソールホームページのカスタマイズ 満足度調査の利用 サービスデスクの添付ファイルのセキュリティの有効化または無効化
サービスデスクダッシュボードの使用 サービスデスクのチケット、プロセス、およびレポートの管理
サービスデスクチケットのライフサイクルの概要 管理者コンソールおよびユーザーコンソールからのチケットの作成 Eメールによるチケットの作成と管理 チケットの表示およびコメントや作業や添付ファイルの管理 チケットのマージ チケットのエスカレーションプロセスの使用 サービスデスクプロセスの使用 チケットルールの使用 サービスデスクレポートの実行 チケットのアーカイブ、復元、削除 チケット削除の管理
サービスデスクチケットキューの管理 ユーザーダウンロードおよびサポート技術情報記事について サービスデスクチケット設定のカスタマイズ SMTP Eメールサーバーの設定
メンテナンスとトラブルシューティング
アプライアンスのメンテナンス
設定の変更の追跡 アプライアンスバックアップについて アプライアンスの復元 アプライアンスソフトウェアの更新 アプライアンスの再起動またはシャットダウン KACEからのOVAL定義の更新 日次実行出力の理解
アプライアンスのトラブルシューティング
付録 用語集 当社について 法的情報

インベントリ設定に対する変更の追跡

インベントリ設定に対する変更の追跡

履歴サブスクリプションが情報を保持するように設定されている場合、設定、資産、およびオブジェクトに加えられた変更の詳細を確認できます。

この情報には、変更を加えた日付および変更を加えたユーザーが含まれており、トラブルシューティングの際に役立ちます。詳細については、「履歴設定について」を参照してください。

インベントリの変更履歴について

デバイスの変更履歴は、最初のレポート作成時に収集された情報に変更が加えられたときに初めて記録されます。

管理対象デバイスによってアプライアンスにインベントリが初めてレポートされたときに、その情報がベースラインレポートとして考慮されます。そのため、その情報は変更履歴に記録されません。

管理者コンソールを使用して手動でデバイスを追加

管理者コンソールを使用して手動でデバイスを追加

デバイスの詳細 ページでデバイス情報を入力して、アプライアンスインベントリにデバイスを手動で追加できます。

手動により追加されたレコードは、アプライアンスまたはエージェントからアクセスまたは変更できません。このため、手動により追加されたレコードのフィールドは、管理者が手動で行う場合のみ更新できます。

1.
デバイス リストに移動します。
a.
アプライアンス管理者コンソール（https://appliance_hostname/admin）にログインします。または、管理ヘッダーに組織メニューを表示 オプションがアプライアンスの 一般設定 で有効になっている場合は、ページの右上隅で、ログイン情報の横にあるドロップダウンリストから組織を選択します。
b.
左側のナビゲーションバーで、インベントリ をクリックして、ダッシュボード をクリックします。
2.
アクションを選択 > 新規作成 > 手動登録デバイス を選択して、デバイスの詳細 ページを表示します。
3.
次のいずれかを実行します。
◦
device.xmlのインポート で、ファイルの選択 をクリックして、デバイスのインベントリ情報が含まれたXMLファイルを検索およびインポートします。Windowsに有効なXMLスキーマおよび管理者コンソールを使用した XML ファイルのアップロードを参照してください。

概要 セクションで、デバイスの 名前 を入力して、手順10にスキップします。

◦
概要 セクションで、次の情報を入力します。

アイテム

説明

データベースフィールド

システム名

デバイスのホスト名またはIPアドレス。

名前

システムの説明

デバイスの説明。

SYSTEM_DESCRIPTION

モデル

デバイスモデル。

CS_MODEL

シャーシタイプ

デバイスのタイプ（デスクトップ、ノートPCなど）。

CHASSIS_TYPE

IPアドレス

デバイスのIPアドレス。

IP

MAC

デバイスのメディアアクセス制御（MAC）アドレス番号。

MAC

OS 名

デバイスのオペレーティングシステム（Windows、Mac OS X、またはLinuxなど）。

OS_NAME

サービスパック

サービスパックのバージョン番号（Windowsのみ）。

SERVICE_PACK

デバイスのタイムゾーン

デバイスにインストールされている KACE エージェントは、このタイムゾーンを使用します。

TZ_AGENT

ユーザー

このデバイスに関連付けられているユーザー。

ユーザー

ドメイン

デバイスのドメイン。

CS_DOMAIN

メモ

任意の追加情報を入力します。

NOTES

4.
ハードウェア セクションで、次の情報を入力します。

アイテム

説明

データベースフィールド

RAMの最大容量

使用可能なランダムアクセスメモリ（RAM）の最大容量。

RAM_MAX

RAMの合計

デバイス上のランダムアクセスメモリ（RAM）の合計容量。

RAM_TOTAL

使用中のRAM

デバイスで使用中のランダムアクセスメモリ（RAM）の容量。

RAM_USED

システム製造元

デバイスの製造元。

CS_MANUFACTURER

システムモデル

デバイスモデル。

CS_MODEL

サービスタグ

デバイスサービスの識別に使用される情報。

SERVICE_TAG

資産タグ

デバイスハードウェアの識別に使用される情報。

ASSET_TAG

マザーボードプライマリバス

メインのバス。

MOTHERBOARD_PRIMARY_BUS

マザーボードセカンダリバス

周辺のバス。

MOTHERBOARD_SECONDARY_BUS

アーキテクチャ

デバイスのオペレーティングシステムのアーキテクチャ（x86、x64など）。

SYS_ARCH

仮想デバイス

仮想デバイス（VMwareプラットフォームで実行されているデバイスなど）の識別に使用されます。物理デバイス（ノートPC、サーバーなど）には表示されません。

VIRTUAL

プロセッサ

CPUの数、タイプ、および製造元。

PROCESSORS

CD/DVDドライブ

デバイスにインストールされたCD-ROMおよびDVD-ROMドライブの設定。

CDROM_DEVICES

サウンドデバイス

デバイス上のオーディオデバイスに関する情報。

SOUND_DEVICES

モニタ

デバイスに接続されているモニタのタイプおよび製造元。仮想デバイスの場合、このフィールドは表示されません。

MONITOR

ビデオコントローラー

デバイス上のビデオコントローラーに関する情報。

VIDEO_CONTROLLERS

BIOS名

BIOS名。

BIOS_NAME

BIOSのリリース日

BIOSのバージョンがリリースされた日。

BIOS_RELEASE_DATE

BIOSバージョン

BIOSのバージョン。

BIOS_VERSION

BIOS製造元

BIOSの製造元。

BIOS_MANUFACTURER

BIOSの説明

BIOSの説明。

BIOS_DESCRIPTION

BIOSの識別コード

BIOSの識別コード。

BIOS_IDENTIFICATION_CODE

BIOSのシリアルナンバー

BIOSのシリアルナンバー。

BIOS_SERIAL_NUMBER

5.
プリンタ セクションで、デバイスに関連するプリンタ情報を指定します。
6.
エージェント セクションで、デバイスにインストールされた KACE エージェントのバージョン番号を指定します。
7.
ユーザー セクションで、ユーザー情報を指定します。

アイテム

説明

データベースフィールド

ログに記録されたユーザー

デバイスに現在ログインしているユーザー。このエントリには、ユーザー名と、そのユーザーが属しているドメインが含まれます。

USER_LOGGED

ユーザーフルネーム

デバイスを所有しているユーザーのフルネーム。

USER_FULLNAME

ユーザードメイン

ユーザーが属しているドメイン。

USER_DOMAIN

最新のユーザー

前回デバイスにログインしたユーザーの名前。一部のデバイスは複数のユーザーが利用している場合があります。

ユーザー

8.
オペレーティングシステム セクションで、デバイスにインストールされているオペレーティングシステムに関する情報を指定します。

アイテム

説明

データベースフィールド

オペレーティングシステムのバージョン

オペレーティングシステムのバージョン番号。

OS_VERSION

オペレーティングシステムのビルドのバージョン

オペレーティングシステムのビルド番号。

OS_BUILD

数値

オペレーティングシステムの番号。

OS_NUMBER

オペレーティングシステムのメジャーバージョン

オペレーティングシステムのメジャーバージョンを識別する番号。

OS_MAJOR

オペレーティングシステムのマイナーバージョン

オペレーティングシステムのマイナーバージョンを識別する番号。

OS_MINOR

マイナーバージョン（2）

追加のオペレーティングシステムのバージョン情報。

OS_MINOR2

Internet Explorerのバージョン

デバイスにインストールされているInternet Explorerのバージョン。

IE_VERSION

.NETのバージョン

デバイスにインストールされている.NETのバージョン。

DOT_NET_VERSIONS

オペレーティングシステムのアーキテクチャ

デバイスのオペレーティングシステムのアーキテクチャ（x86、x64など）。

OS_ARCH

オペレーティングシステム OS 名

デバイスのオペレーティングシステムの名前。

OS_NAME

Edge のバージョン

デバイスにインストールされている Microsoft Edge のバージョン。

EDGE_VERSION

ファミリ

オペレーティングシステムの製品ファミリ。

OS_FAMILY

サービスパック

オペレーティングシステムのインストール日

オペレーティングシステムがインストールされた日付。

OS_INSTALLED_DATE

前回のスタートアップ

前回オペレーティングシステムがシャットダウンされた日時。

LAST_REBOOT

前回のシステムシャットダウン

前回オペレーティングシステムがシャットダウンされた日時。

LAST_SHUTDOWN

前回の再起動からの稼働時間

オペレーティングシステムの稼働時間。

LAST_REBOOT

ドメイン

デバイスのドメイン。

CS_DOMAIN

システムディレクトリ

システムディレクトリの場所。

SYSTEM_DIRECTORY

レジストリサイズ

レジストリのサイズ。

REGISTRY_SIZE

レジストリの最大サイズ

レジストリの最大サイズ。

REGISTRY_MAX_SIZE

WMIのステータス

Windows Management Instrumentation（WMI）サービスのステータス（Windowsデバイスのみ）。

WMI_STATUS

9.
保存 をクリックします。

手動で追加したデバイスのアイコンが デバイス ページのデバイスの ステータス 列に表示されます。手動で追加したデバイスのインベントリは、手動で更新する必要があります。

APIを使用したデバイスの手動追加

APIを使用したデバイスの手動追加

APIを使用したインベントリ情報の送信
サンプルPerlスクリプト
Windowsに有効なXMLスキーマ
WindowsデバイスでのXMLスキーマの使用例
LinuxおよびMacデバイスに有効なXMLスキーマ
管理者コンソールを使用した XML ファイルのアップロード

XML ファイルを作成し、そのファイルを API（アプリケーションプログラミングインターフェイス）を使用してアプライアンスにアップロードすることで、デバイスを手動でアプライアンスに追加することができます。この方法でデバイスを追加すると、セキュリティ上の理由から KACE エージェントを実行できないデバイスや、LAN（ローカルエリアネットワーク）に接続してインベントリをレポートできないデバイスにとって役立ちます。

このセクションのサンプルスクリプトを手本にしてXMLファイルを作成できます。

API を通じてインベントリに追加されたデバイスは、ライセンス制限にカウントされません。詳細については、「製品ライセンス情報の表示」を参照してください。

API を通じてアップロードされたアプリケーションインベントリは ソフトウェア ページには表示されますが、ソフトウェアカタログ ページには表示されません。詳細については、以下を参照してください。

•
ソフトウェア ページでのアプリケーション管理
•
ソフトウェアカタログインベントリの管理
* 
注: インベントリAPIは、アプライアンスの設定に応じて、HTTP通信およびHTTPS通信をサポートします。インベントリ情報をアップロードするには、以下のURLを使用します。http://appliance_hostname/service/wsapi.php。ここで、appliance_hostname は、アプライアンスのホスト名です。
APIを使用したインベントリ情報の送信

APIを使用してインベントリを送信するには、最初にインベントリ情報が含まれるXMLファイルを生成する必要があります。

例については、次を参照してください。

•
Windowsに有効なXMLスキーマ
•
WindowsデバイスでのXMLスキーマの使用例
•
LinuxおよびMacデバイスに有効なXMLスキーマ

必要なコンテンツが含まれているXMLファイルを生成したら、APIを使用してインベントリを送信できます。

1.
（必須）セッションキーを要求します。
要求を送信する際、本文に「keyreq=true」を含めると、応答でセッション文字列が返されます。
2.
（必須）認証トークンを構成します。
a.
次のようなauth文字列を構成します。
session_string + '|' + MD5 of API password
b.
auth文字列でMD5を実行します。
3.
（新しいデバイスの場合に必須）デバイスのUUIDを要求します。
要求を送信する際、本文に「req=newuuid&key=$auth」を含めると、応答で UUID が返されます。
4.
（必須）インベントリXMLデータを送信します。

要求を送信する際、本文のGET行とインベントリXMLに「req=loadxml&key=$auth&KUID=$uuid&version=6.0」を含めます。

詳細については、「サンプルPerlスクリプト」を参照してください。

サンプルPerlスクリプト

Perlスクリプトを使用して、デバイスのインベントリ情報が含まれたXMLファイルをアプライアンスにアップロードできます。

以下は、ユーザーによって作成された XML ファイルをアプライアンスにアップロードするサンプル Perl スクリプトです。このスクリプトの使用については、Questサポート（https://support.quest.com/contact-support）にお問い合わせください。


#!/usr/bin/perl
use strict;
use warnings;
use WWW::Curl::Easy;
use XML::Simple;
use Data::Dumper;
use Digest::MD5 qw(md5 md5_hex md5_base64);

# Curl出力ハンドラ ...
my $response;
sub write_data($$$$) {
$response = shift;
return length($response);
}

# -----------------------------------------------------
#アプライアンス設定 ...
# -----------------------------------------------------
my $password = "xxx"; # password set in Settings -> Security Settings
my $host = "hostname"; # hostname or IP address here
my $http = "https"; # HTTP or HTTPS

# --------------------------------------------------------
# XMLパッケージの構築 ...
# --------------------------------------------------------
my $simple = new XML::Simple(keeproot => 1, forcearray => 1);
my $data = $simple->XMLin("machine.xml");
my $uuid = $data->{MachineStruct}->[0]->{MAC}->[0];

# --------------------------------------------------------
# CURLスタッフの設定 ...
# --------------------------------------------------------
my $url = "$http://$host/service/wsapi.php";
my $ch = WWW::Curl::Easy->new;
$ch->setopt(CURLOPT_URL, $url); # set url to post to
$ch->setopt(CURLOPT_SSL_VERIFYPEER, 0); # ok for self-signed ca
$ch->setopt(CURLOPT_VERBOSE, 0);
$ch->setopt(CURLOPT_WRITEFUNCTION, \&write_data); # return into a variable
$ch->setopt(CURLOPT_HEADER, 0);
$ch->setopt(CURLOPT_TIMEOUT, 40); # times out after 4s
$ch->setopt(CURLOPT_POST, 1);
$ch->setopt(CURLOPT_COOKIEFILE, '/tmp/cookiefile.txt');

# --------------------------------------------------------
#手順 1 - アプライアンスからのセッションの要求 ...
# --------------------------------------------------------
$ch->setopt(CURLOPT_POSTFIELDS, "keyreq=true"); # add POST fields
my $out = $ch->perform;
if ( $out != 0 ) {
die ("Error: $out " .
$ch->strerror($out).
" " .
$ch->errbuf."\n");
}
my $sess = $response;

# --------------------------------------------------------
#手順2 - 認証トークンの構築...
# --------------------------------------------------------
my $auth = md5_hex("$sess|".md5_hex($password));

# --------------------------------------------------------
#手順 3 - アプライアンスのからの新規 UUID の要求（新しいデバイスレコードを
# 作成する場合。 既存のデバイスを編集する場合は、
# XMLでUUIDが設定されていることを要確認）...
# --------------------------------------------------------
if ( 1 ) {
print "Using UUID From XML File: $uuid\n";
} else {
$ch->setopt(CURLOPT_POSTFIELDS,"req=newuuid&key=$auth");
$out = $ch->perform;
if ( $out != 0 ) {
die ("Error: $out " .
$ch->strerror($out).
" " .
$ch->errbuf."\n");
}
$uuid = $response;
$data->{MachineStruct}->[0]->{MAC}->[0] = $uuid;
$data->{MachineStruct}->[0]->{NAME}->[0] = "WSAPI-" .$uuid;
print "Created New UUID: $uuid\n";
}

#シンプルなXMLハッシュをXML文字列に変換 ...
my $xml = $simple->XMLout(
$data,
KeepRoot => 1,
NoAttr => 1,
);

# --------------------------------------------------------
#手順 4 - アプライアンスへの XML の送信 ...
# --------------------------------------------------------
my @curlHeader = ("Content-Type: text/xml");
$url = "$http://$host/service/wsapi.php?req=loadxml&key=$auth&KUID=$uuid&version=6.0";
$ch->setopt(CURLOPT_URL, $url); # set url to post to
$ch->setopt(CURLOPT_HTTPHEADER, \@curlHeader);
$ch->setopt(CURLOPT_POSTFIELDS, $xml);
$out = $ch->perform;
if ( $out != 0 ) {
die ("Error: $out " .$ch->strerror($out)." " .$ch->errbuf."\n");
}

print "Loaded $uuid to the appliance ($host)\n";

Windowsに有効なXMLスキーマ

Windowsデバイスのインベントリ情報のアップロードに使用されるファイルは、有効なXMLスキーマに従っている必要があります。

以下は、Windowsデバイスに有効なXMLスキーマの例です。


<?xml version="1.0" encoding="utf-8"?>
<MachineStruct xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi=">
http://www.w3.org/2001/XMLSchema-instance"
<NAME>@@__m_computerSystemName__@@</NAME>
<IP>@@__m_IPAddress__@@</IP>
<MAC>@@__m_versionKaceId__@@</MAC>
<OS_NAME>@@__m_operatingSystemCaption__@@</OS_NAME>
<OS_NUMBER>@@__m_operatingSystemVersion__@@</OS_NUMBER>
<OS_MAJOR>@@__m_operatingSystemVersionMajor__@@</OS_MAJOR>
<OS_MINOR>@@__m_operatingSystemVersionMinor__@@</OS_MINOR>
<SERVICE_PACK>@@__m_operatingSystemCsdVersion__@@</SERVICE_PACK>
<USER>@@__m_userAccountName__@@</USER>
<USER_FULLNAME>@@__m_userAccountFullName__@@</USER_FULLNAME>
<DOMAIN>@@__m_computerSystemDomain__@@</DOMAIN>
<OS_VERSION>@@__m_operatingSystemVersion__@@</OS_VERSION>
<OS_BUILD>@@__m_operatingSystemBuildNumber__@@</OS_BUILD>
<OS_INSTALLED_DATE>@@__m_operatingSystemInstallDate__@@</OS_INSTALLED_DATE>
<LAST_REBOOT>@@__m_operatingSystemLastBootupTime__@@</LAST_REBOOT>
<LAST_SHUTDOWN>@@__m_operatingSystemLastBootupTime__@@</LAST_SHUTDOWN>
<UPTIME>@@__m_operatingSystemUptime__@@</UPTIME>
<SYSTEM_DIRECTORY>@@__m_operatingSystemWindowsDirectory__@@</SYSTEM_DIRECTORY>
<SYSTEM_DESCRIPTION>@@__m_operatingSystemDescription__@@</SYSTEM_DESCRIPTION>
<RAM_TOTAL>@@__m_physicalMemoryTotalSize__@@</RAM_TOTAL>
<RAM_USED>@@__m_operatingSystemUsedPhysicalMemory__@@</RAM_USED>
<CS_MANUFACTURER>@@__m_computerSystemManufacturer__@@</CS_MANUFACTURER>
<CS_MODEL>@@__m_computerSystemModel__@@</CS_MODEL>
<CHASSIS_TYPE>@@__m_systemEnclosureChassisType__@@</CHASSIS_TYPE>
<TZ_AGENT>@@__m_versionTimeZone__@@</TZ_AGENT>
<USER_LOGGED>@@__m_computerSystemUserName__@@</USER_LOGGED>
<CS_DOMAIN>@@__m_computerSystemDomain__@@</CS_DOMAIN>
<USER_NAME>@@__m_userAccountName__@@</USER_NAME>
<USER_DOMAIN>@@__m_userAccountDomain__@@</USER_DOMAIN>
<BIOS_NAME>@@__m_biosName__@@</BIOS_NAME>
<BIOS_VERSION>@@__m_biosVersion__@@</BIOS_VERSION>
<BIOS_MANUFACTURER>@@__m_biosManufacturer__@@</BIOS_MANUFACTURER>
<BIOS_DESCRIPTION>@@__m_biosDescription__@@</BIOS_DESCRIPTION>
<BIOS_SERIAL_NUMBER>@@__m_biosSerialNumber__@@</BIOS_SERIAL_NUMBER>
<MOTHERBOARD_PRIMARY_BUS>@@__m_motherboardDevicePrimaryBusType__@@
</MOTHERBOARD_PRIMARY_BUS>
<MOTHERBOARD_SECONDARY_BUS>@@__m_motherboardDeviceSecondaryBusType__@@
</MOTHERBOARD_SECONDARY_BUS>
<PROCESSORS>CPU Chip Count: @@__m_processorCount__@@
CPU Core Count: @@__m_processorCoreCount__@@
@@__m_processorList__@@ </PROCESSORS>
<SOUND_DEVICES>@@__m_soundDeviceDescription__@@</SOUND_DEVICES>
<CDROM_DEVICES>@@__m_CDROMDeviceName__@@</CDROM_DEVICES>
<VIDEO_CONTROLLERS>@@__m_videoControllerName__@@</VIDEO_CONTROLLERS>
<REGISTRY_SIZE>@@__m_registryCurrentSize__@@</REGISTRY_SIZE>
<REGISTRY_MAX_SIZE>@@__m_registryMaximumSize__@@</REGISTRY_MAX_SIZE>
<DISK_DRIVES>
@@__m_logicalDiskDriveList__@@ </DISK_DRIVES>
<NETWORK_INTERFACES>
@@__m_networkAdapterConfigurationList__@@ </NETWORK_INTERFACES>
<PRINTERS>@@__m_printerList__@@</PRINTERS>
<STARTUP_PROGRAMS>
@@__m_startupProgramsList__@@ </STARTUP_PROGRAMS>
<PROCESSES>
@@__m_processList__@@ </PROCESSES>
<NT_SERVICES>
@@__m_servicesList__@@ </NT_SERVICES>
<INSTALLED_software>
@@__m_installedProgramsList__@@ </INSTALLED_software>
<CLIENT_VERSION>@@__m_appVersion__@@</CLIENT_VERSION>
</MachineStruct>
WindowsデバイスでのXMLスキーマの使用例

Windowsデバイスの有効なXMLスキーマに適合するファイル例を表示できます。

以下は、Windowsに有効なXMLスキーマに示されているスキーマを使用した有効な XML の例です。


<?xml version="1.0" encoding="utf-8"?>
<MachineStruct xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<NAME>TestComputer</NAME>
<IP>10.10.10.10</IP>
<MAC>F1234567-C2D2-4055-85BB-294E6A3D22D9</MAC>
<OS_NAME>Microsoft Windows 7 Professional</OS_NAME>
<OS_NUMBER>6.1.7601.17514</OS_NUMBER>
<OS_MAJOR>6</OS_MAJOR>
<OS_MINOR>1</OS_MINOR>
<SERVICE_PACK>Service Pack 1</SERVICE_PACK>
<USER>Administrator</USER>
<USER_FULLNAME>Tom Silver</USER_FULLNAME>
<DOMAIN>WORK</DOMAIN>
<OS_VERSION>6.1.7601</OS_VERSION>
<OS_BUILD>17514</OS_BUILD>
<OS_INSTALLED_DATE>2017-08-30 14:22:39 -0400</OS_INSTALLED_DATE>
<LAST_REBOOT>2017-08-30 14:25:05 -0400</LAST_REBOOT>
<LAST_SHUTDOWN>2017-08-30 14:25:05 -0400</LAST_SHUTDOWN>
<UPTIME>4 days </UPTIME>
<SYSTEM_DIRECTORY>C:\WINDOWS</SYSTEM_DIRECTORY>
<SYSTEM_DESCRIPTION>Windows 7 Machine</SYSTEM_DESCRIPTION>
<RAM_TOTAL>512.00MB</RAM_TOTAL>
<RAM_USED>180MB</RAM_USED>
<CS_MANUFACTURER>VMware, Inc.</CS_MANUFACTURER>
<CS_MODEL>VMware Virtual Platform</CS_MODEL>
<CHASSIS_TYPE>Other</CHASSIS_TYPE>
<USER_LOGGED>Tom</USER_LOGGED>
<CS_DOMAIN>WORK</CS_DOMAIN>
<USER_NAME>Administrator</USER_NAME>
<USER_DOMAIN>Work</USER_DOMAIN>
<BIOS_NAME>PhoenixBIOS 4.0 Release 5.5 </BIOS_NAME>
<BIOS_VERSION>INTEL - 6040000</BIOS_VERSION>
<BIOS_MANUFACTURER>Phoenix Technologies LTD</BIOS_MANUFACTURER>
<BIOS_DESCRIPTION>PhoenixBIOS 4.0 Release 5.5 </BIOS_DESCRIPTION>
<BIOS_SERIAL_NUMBER>VMware-56 4d bd d3 5e 4f a5 4e-6a ce a0 d3 39 bd ae 02
</BIOS_SERIAL_NUMBER>
<MOTHERBOARD_PRIMARY_BUS>PCI</MOTHERBOARD_PRIMARY_BUS>
<MOTHERBOARD_SECONDARY_BUS>ISA</MOTHERBOARD_SECONDARY_BUS>
<PROCESSORS>CPU Chip Count: 1
CPU Core Count: 0
CPU0: Intel Celeron processor (0 cores) </PROCESSORS>
<SOUND_DEVICES>Creative AudioPCI (ES1371,ES1373) (WDM)
</SOUND_DEVICES>
<CDROM_DEVICES>TSSTcorp DVD+-RW TS-U633F
</CDROM_DEVICES>
<VIDEO_CONTROLLERS>VMware SVGA II
</VIDEO_CONTROLLERS>
<REGISTRY_SIZE>1MB</REGISTRY_SIZE>
<REGISTRY_MAX_SIZE>86MB</REGISTRY_MAX_SIZE>
<DISK_DRIVES>
<DiskDrive>
<NAME>Drive C: (Physical Disk) FileSystem: NTFS Used: 2.08GB Total: 39.99GB</NAME>
<DISK_SIZE>39.9906</DISK_SIZE>
<DISK_USED>2.07966</DISK_USED>
<DISK_FREE>37.9109</DISK_FREE>
<PERCENT_USED>5.2</PERCENT_USED>
</DiskDrive>
</DISK_DRIVES>
<NETWORK_INTERFACES>
<NetworkInterface>
<NIC>AMD PCNET Family PCI Ethernet Adapter - Packet Scheduler
Miniport</NIC>
<MAC>00:0C:29:BD:AE:03</MAC>
<IP>192.168.220.132</IP>
<DHCP_ENABLED>True</DHCP_ENABLED>
</NetworkInterface>
</NETWORK_INTERFACES>
<PRINTERS></PRINTERS>
<STARTUP_PROGRAMS>
<StartupProgram>
<NAME>desktop</NAME>
</StartupProgram>
<StartupProgram>
<NAME>VMware Tools</NAME>
<COMMAND_EXE>C:\Program Files\VMware\VMware Tools\VMwareTray.exe</COMMAND_EXE>
<COMMAND_ARGS />
<FILE_INFO>
<FILE_NAME>VMwareTray.exe</FILE_NAME>
<FILE_DESCRIPTION>VMware Tools tray application</FILE_DESCRIPTION>
<FILE_VERSION>8.4.6.16648</FILE_VERSION>
<PRODUCT_NAME>VMware Tools</PRODUCT_NAME>
<PRODUCT_VERSION>8.4.6 build-385536</PRODUCT_VERSION>
<COMPANY_NAME>VMware, Inc.</COMPANY_NAME>
</FILE_INFO>
</StartupProgram>
<StartupProgram>
<NAME>VMware User Process</NAME>
<COMMAND_EXE>C:\Program Files\VMware\VMware Tools\VMwareUser.exe</COMMAND_EXE>
<COMMAND_ARGS />
<FILE_INFO>
<FILE_NAME>VMwareUser.exe</FILE_NAME>
<FILE_DESCRIPTION>VMware Tools Service</FILE_DESCRIPTION>
<FILE_VERSION>8.4.6.16648</FILE_VERSION>
<PRODUCT_NAME>VMware Tools</PRODUCT_NAME>
<PRODUCT_VERSION>8.4.6 build-385536</PRODUCT_VERSION>
<COMPANY_NAME>VMware, Inc.</COMPANY_NAME>
</FILE_INFO>
</StartupProgram>
</STARTUP_PROGRAMS>
<PROCESSES>
<MachineProcess>
<NAME>konea.exe</NAME>
<COMMAND_EXE>C:\Program Files (x86)\Quest\KACE\konea.exe</COMMAND_EXE>
<COMMAND_ARGS/>
<FILE_INFO>
<FILE_NAME>konea.exe</FILE_NAME>
<FILE_DESCRIPTION>konea</FILE_DESCRIPTION>
<FILE_VERSION>255.239.6</FILE_VERSION>
<PRODUCT_NAME>KACE Agent</PRODUCT_NAME>
<PRODUCT_VERSION>255.239.6</PRODUCT_VERSION>
<COMPANY_NAME>Quest Software Inc.</COMPANY_NAME>
</FILE_INFO>
</MachineProcess>
</PROCESSES>
<NT_SERVICES>
<NtService>
<NAME>Alerter</NAME>
<DISPLAY_NAME>Alerter</DISPLAY_NAME>
<STATUS>SERVICE_STOPPED</STATUS>
<STARTUP_TYPE>SERVICE_DISABLED</STARTUP_TYPE>
<DESCRIPTION />
<LOGON_AS_USER>NT AUTHORITY\LocalService</LOGON_AS_USER>
<CAN_INTERACT_WITH_DESKTOP>False</CAN_INTERACT_WITH_DESKTOP>
<COMMAND_EXE>C:\WINDOWS\system32\svchost.exe</COMMAND_EXE>
<COMMAND_ARGS> -k LocalService</COMMAND_ARGS>
<FILE_INFO>
<FILE_NAME>svchost.exe</FILE_NAME>
<FILE_DESCRIPTION>Generic Host Process for Win32 Services</FILE_DESCRIPTION>
<FILE_VERSION>6.1.7600.16385 (win7_rtm.090713-1255)</FILE_VERSION>
<PRODUCT_NAME>Microsoft?? Windows?? Operating System</PRODUCT_NAME>
<PRODUCT_VERSION>6.1.7600.16385</PRODUCT_VERSION>
<COMPANY_NAME>Microsoft Corporation</COMPANY_NAME>
</FILE_INFO>
</NtService>
</NT_SERVICES>
<INSTALLED_software>
<software>
<DISPLAY_VERSION>5.2.38916</DISPLAY_VERSION>
<HELP_LINK />
<README />
<INSTALL_DATE>20170830</INSTALL_DATE>
<PUBLISHER>Quest Software Inc.</PUBLISHER>
<UNINSTALL_STRING />
<URLINFO_ABOUT />
<DISPLAY_NAME>Quest KACE Agent</DISPLAY_NAME>
</software>
</INSTALLED_software>
<CLIENT_VERSION>8.0.xxxxx</CLIENT_VERSION>
</MachineStruct>
LinuxおよびMacデバイスに有効なXMLスキーマ

LinuxおよびMacデバイスのインベントリ情報のアップロードに使用されるファイルは、有効なXMLスキーマを使用する必要があります。

以下は、LinuxおよびMacデバイス向けのXMLスキーマの例です。


<?xml version="1.0" encoding="utf-8"?>
<MachineStruct>
<NAME>@@__m_versionHostName__@@</NAME>
<CLIENT_VERSION>@@__m_appVersion__@@</CLIENT_VERSION>
<IP>@@__m_IPAddress__@@</IP>
<MAC>@@__m_versionKaceId__@@</MAC>
<OS_NAME>@@__m_operatingSystemCaption__@@</OS_NAME>
<OS_NUMBER>@@__m_operatingSystemVersion__@@</OS_NUMBER>
<OS_MAJOR>@@__m_operatingSystemVersionMajor__@@</OS_MAJOR>
<OS_MINOR>@@__m_operatingSystemVersionMinor__@@</OS_MINOR>
<SERVICE_PACK></SERVICE_PACK>
<INSTALL_DATE></INSTALL_DATE>

<OS_ARCH>@@__m_operatingSystemOSArchitecture__@@</OS_ARCH>
<OS_FAMILY>@@__m_operatingSystemOSFamily__@@</OS_FAMILY>
<OS_VERSION>@@__m_operatingSystemVersion__@@</OS_VERSION>
<OS_BUILD>@@__m_operatingSystemBuildNumber__@@</OS_BUILD>
<DOMAIN>@@__m_userAccountDomain__@@</DOMAIN>
<CS_DOMAIN>@@__m_userAccountDomain__@@</CS_DOMAIN>

<LAST_REBOOT>@@__m_operatingSystemLastBootupTime__@@</LAST_REBOOT>
<TZ_AGENT>@@__m_versionTimeZone__@@</TZ_AGENT>
<UPTIME>@@__m_operatingSystemUptime__@@</UPTIME>

<RAM_TOTAL>@@__m_operatingSystemTotalVisibleMemorySize__@@</RAM_TOTAL>
<RAM_USED>@@__m_operatingSystemUsedPhysicalMemory__@@</RAM_USED>
<CS_MANUFACTURER>@@__m_biosManufacturer__@@</CS_MANUFACTURER>
<CS_MODEL></CS_MODEL>
<USER_LOGGED>@@__m_userAccountName__@@</USER_LOGGED>
<USER>@@__m_userAccountName__@@</USER>
<USER_NAME>@@__m_userAccountName__@@</USER_NAME>
<USER_FULLNAME>@@__m_userAccountFullName__@@</USER_FULLNAME>
<USER_DOMAIN>@@__m_userAccountDomain__@@</USER_DOMAIN>
<BIOS_NAME>@@__m_biosName__@@</BIOS_NAME>
<BIOS_VERSION>@@__m_biosVersion__@@</BIOS_VERSION>
<BIOS_MANUFACTURER>@@__m_biosManufacturer__@@</BIOS_MANUFACTURER>
<BIOS_DESCRIPTION>@@__m_biosName__@@</BIOS_DESCRIPTION>
<BIOS_SERIAL_NUMBER>@@__m_biosSerialNumber__@@</BIOS_SERIAL_NUMBER>
<MOTHERBOARD_PRIMARY_BUS></MOTHERBOARD_PRIMARY_BUS>
<MOTHERBOARD_SECONDARY_BUS></MOTHERBOARD_SECONDARY_BUS>
<PROCESSORS>@@__m_processorList__@@</PROCESSORS>
<SOUND_DEVICES>@@__m_soundDeviceDescription__@@</SOUND_DEVICES>
<CDROM_DEVICES>@@__m_CDROMDeviceName__@@</CDROM_DEVICES>
<MONITOR>@@__m_desktopMonitorDescription__@@</MONITOR>

<VIDEO_CONTROLLERS>@@__m_videoControllerName__@@</VIDEO_CONTROLLERS>
<DISK_DRIVES>
@@__m_logicalDiskDriveList__@@</DISK_DRIVES>
<NETWORK_INTERFACES>
@@__m_networkAdapterConfigurationList__@@</NETWORK_INTERFACES>
<PRINTERS>@@__m_printerList__@@</PRINTERS>
<STARTUP_PROGRAMS>
@@__m_startupProgramsList__@@</STARTUP_PROGRAMS>
<PROCESSES>
@@__m_processList__@@</PROCESSES>
<INSTALLED_software>
@@__m_installedProgramsList__@@</INSTALLED_software>
</MachineStruct>
管理者コンソールを使用した XML ファイルのアップロード

管理者コンソールを使用して、デバイスのインベントリ情報が含まれた XML ファイルをアップロードできます。このタイプの情報は、手動インベントリ情報と呼ばれます。

KACE エージェントが、インベントリ情報が追加されたデバイスにインストールされています。

インベントリに追加されるデバイスで XML ファイルを作成し、アプライアンスに移動してこのファイルをアップロードします。

手動インベントリ情報は ソフトウェア ページに表示されますが、ソフトウェアカタログ ページには表示されません。詳細については、以下を参照してください。

•
ソフトウェア ページでのアプリケーション管理
•
ソフトウェアカタログインベントリの管理
1.
情報が含まれるXMLファイルを生成します。
a.
KACE エージェントがインストールされているデバイス上で、コマンドプロンプトまたはターミナルウィンドウを開きます。
b.
Quest KACEのインストールディレクトリに移動します。
例：
▪
Windows 32ビットシステム：C:\Program Files\Quest\KACE
▪
Windows 64ビットシステム：C:\Program Files (x86)\Quest\KACE
▪
Mac OS Xシステム：/Library/Application Support/Quest/KACE/bin
▪
Linuxシステム：/opt/quest/kace/bin
c.
次のコマンドを入力します:
KInventory -machine -output filename

ここでのfilenameは、作成するXMLファイルへのパスです。パスにスペースが含まれる場合は、二重引用符でパス全体を囲みます。

エージェントでインベントリデータが収集され、XMLファイルが生成されます。

2.
アプライアンスの管理者コンソールで、デバイス リストに移動します。
a.
アプライアンス管理者コンソール（https://appliance_hostname/admin）にログインします。または、管理ヘッダーに組織メニューを表示 オプションがアプライアンスの 一般設定 で有効になっている場合は、ページの右上隅で、ログイン情報の横にあるドロップダウンリストから組織を選択します。
b.
左側のナビゲーションバーで、インベントリ をクリックして、ダッシュボード をクリックします。
3.
アクションの選択 > 新規作成 > 手動登録デバイスを選択して、デバイスの詳細 ページを表示します。
4.
Import Device（デバイスのインポート） で、参照 をクリックします。
5.
ファイルを選択し、開く または 選択 をクリックします。
6.
保存 をクリックします。

デバイスの情報がインベントリに追加されます。XMLファイルをアップロードした場合、アプライアンスによりページ上の他のすべての情報が無視され、インベントリ情報にXMLファイルが使用されます。

APIを使用したインベントリ情報の送信

APIを使用したデバイスの手動追加

APIを使用したインベントリ情報の送信
サンプルPerlスクリプト
Windowsに有効なXMLスキーマ
WindowsデバイスでのXMLスキーマの使用例
LinuxおよびMacデバイスに有効なXMLスキーマ
管理者コンソールを使用した XML ファイルのアップロード

XML ファイルを作成し、そのファイルを API（アプリケーションプログラミングインターフェイス）を使用してアプライアンスにアップロードすることで、デバイスを手動でアプライアンスに追加することができます。この方法でデバイスを追加すると、セキュリティ上の理由から KACE エージェントを実行できないデバイスや、LAN（ローカルエリアネットワーク）に接続してインベントリをレポートできないデバイスにとって役立ちます。

このセクションのサンプルスクリプトを手本にしてXMLファイルを作成できます。

API を通じてインベントリに追加されたデバイスは、ライセンス制限にカウントされません。詳細については、「製品ライセンス情報の表示」を参照してください。

API を通じてアップロードされたアプリケーションインベントリは ソフトウェア ページには表示されますが、ソフトウェアカタログ ページには表示されません。詳細については、以下を参照してください。

•
ソフトウェア ページでのアプリケーション管理
•
ソフトウェアカタログインベントリの管理
* 
注: インベントリAPIは、アプライアンスの設定に応じて、HTTP通信およびHTTPS通信をサポートします。インベントリ情報をアップロードするには、以下のURLを使用します。http://appliance_hostname/service/wsapi.php。ここで、appliance_hostname は、アプライアンスのホスト名です。
APIを使用したインベントリ情報の送信

APIを使用してインベントリを送信するには、最初にインベントリ情報が含まれるXMLファイルを生成する必要があります。

例については、次を参照してください。

•
Windowsに有効なXMLスキーマ
•
WindowsデバイスでのXMLスキーマの使用例
•
LinuxおよびMacデバイスに有効なXMLスキーマ

必要なコンテンツが含まれているXMLファイルを生成したら、APIを使用してインベントリを送信できます。

1.
（必須）セッションキーを要求します。
要求を送信する際、本文に「keyreq=true」を含めると、応答でセッション文字列が返されます。
2.
（必須）認証トークンを構成します。
a.
次のようなauth文字列を構成します。
session_string + '|' + MD5 of API password
b.
auth文字列でMD5を実行します。
3.
（新しいデバイスの場合に必須）デバイスのUUIDを要求します。
要求を送信する際、本文に「req=newuuid&key=$auth」を含めると、応答で UUID が返されます。
4.
（必須）インベントリXMLデータを送信します。

要求を送信する際、本文のGET行とインベントリXMLに「req=loadxml&key=$auth&KUID=$uuid&version=6.0」を含めます。

詳細については、「サンプルPerlスクリプト」を参照してください。

サンプルPerlスクリプト

Perlスクリプトを使用して、デバイスのインベントリ情報が含まれたXMLファイルをアプライアンスにアップロードできます。

以下は、ユーザーによって作成された XML ファイルをアプライアンスにアップロードするサンプル Perl スクリプトです。このスクリプトの使用については、Questサポート（https://support.quest.com/contact-support）にお問い合わせください。


#!/usr/bin/perl
use strict;
use warnings;
use WWW::Curl::Easy;
use XML::Simple;
use Data::Dumper;
use Digest::MD5 qw(md5 md5_hex md5_base64);

# Curl出力ハンドラ ...
my $response;
sub write_data($$$$) {
$response = shift;
return length($response);
}

# -----------------------------------------------------
#アプライアンス設定 ...
# -----------------------------------------------------
my $password = "xxx"; # password set in Settings -> Security Settings
my $host = "hostname"; # hostname or IP address here
my $http = "https"; # HTTP or HTTPS

# --------------------------------------------------------
# XMLパッケージの構築 ...
# --------------------------------------------------------
my $simple = new XML::Simple(keeproot => 1, forcearray => 1);
my $data = $simple->XMLin("machine.xml");
my $uuid = $data->{MachineStruct}->[0]->{MAC}->[0];

# --------------------------------------------------------
# CURLスタッフの設定 ...
# --------------------------------------------------------
my $url = "$http://$host/service/wsapi.php";
my $ch = WWW::Curl::Easy->new;
$ch->setopt(CURLOPT_URL, $url); # set url to post to
$ch->setopt(CURLOPT_SSL_VERIFYPEER, 0); # ok for self-signed ca
$ch->setopt(CURLOPT_VERBOSE, 0);
$ch->setopt(CURLOPT_WRITEFUNCTION, \&write_data); # return into a variable
$ch->setopt(CURLOPT_HEADER, 0);
$ch->setopt(CURLOPT_TIMEOUT, 40); # times out after 4s
$ch->setopt(CURLOPT_POST, 1);
$ch->setopt(CURLOPT_COOKIEFILE, '/tmp/cookiefile.txt');

# --------------------------------------------------------
#手順 1 - アプライアンスからのセッションの要求 ...
# --------------------------------------------------------
$ch->setopt(CURLOPT_POSTFIELDS, "keyreq=true"); # add POST fields
my $out = $ch->perform;
if ( $out != 0 ) {
die ("Error: $out " .
$ch->strerror($out).
" " .
$ch->errbuf."\n");
}
my $sess = $response;

# --------------------------------------------------------
#手順2 - 認証トークンの構築...
# --------------------------------------------------------
my $auth = md5_hex("$sess|".md5_hex($password));

# --------------------------------------------------------
#手順 3 - アプライアンスのからの新規 UUID の要求（新しいデバイスレコードを
# 作成する場合。 既存のデバイスを編集する場合は、
# XMLでUUIDが設定されていることを要確認）...
# --------------------------------------------------------
if ( 1 ) {
print "Using UUID From XML File: $uuid\n";
} else {
$ch->setopt(CURLOPT_POSTFIELDS,"req=newuuid&key=$auth");
$out = $ch->perform;
if ( $out != 0 ) {
die ("Error: $out " .
$ch->strerror($out).
" " .
$ch->errbuf."\n");
}
$uuid = $response;
$data->{MachineStruct}->[0]->{MAC}->[0] = $uuid;
$data->{MachineStruct}->[0]->{NAME}->[0] = "WSAPI-" .$uuid;
print "Created New UUID: $uuid\n";
}

#シンプルなXMLハッシュをXML文字列に変換 ...
my $xml = $simple->XMLout(
$data,
KeepRoot => 1,
NoAttr => 1,
);

# --------------------------------------------------------
#手順 4 - アプライアンスへの XML の送信 ...
# --------------------------------------------------------
my @curlHeader = ("Content-Type: text/xml");
$url = "$http://$host/service/wsapi.php?req=loadxml&key=$auth&KUID=$uuid&version=6.0";
$ch->setopt(CURLOPT_URL, $url); # set url to post to
$ch->setopt(CURLOPT_HTTPHEADER, \@curlHeader);
$ch->setopt(CURLOPT_POSTFIELDS, $xml);
$out = $ch->perform;
if ( $out != 0 ) {
die ("Error: $out " .$ch->strerror($out)." " .$ch->errbuf."\n");
}

print "Loaded $uuid to the appliance ($host)\n";

Windowsに有効なXMLスキーマ

Windowsデバイスのインベントリ情報のアップロードに使用されるファイルは、有効なXMLスキーマに従っている必要があります。

以下は、Windowsデバイスに有効なXMLスキーマの例です。


<?xml version="1.0" encoding="utf-8"?>
<MachineStruct xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi=">
http://www.w3.org/2001/XMLSchema-instance"
<NAME>@@__m_computerSystemName__@@</NAME>
<IP>@@__m_IPAddress__@@</IP>
<MAC>@@__m_versionKaceId__@@</MAC>
<OS_NAME>@@__m_operatingSystemCaption__@@</OS_NAME>
<OS_NUMBER>@@__m_operatingSystemVersion__@@</OS_NUMBER>
<OS_MAJOR>@@__m_operatingSystemVersionMajor__@@</OS_MAJOR>
<OS_MINOR>@@__m_operatingSystemVersionMinor__@@</OS_MINOR>
<SERVICE_PACK>@@__m_operatingSystemCsdVersion__@@</SERVICE_PACK>
<USER>@@__m_userAccountName__@@</USER>
<USER_FULLNAME>@@__m_userAccountFullName__@@</USER_FULLNAME>
<DOMAIN>@@__m_computerSystemDomain__@@</DOMAIN>
<OS_VERSION>@@__m_operatingSystemVersion__@@</OS_VERSION>
<OS_BUILD>@@__m_operatingSystemBuildNumber__@@</OS_BUILD>
<OS_INSTALLED_DATE>@@__m_operatingSystemInstallDate__@@</OS_INSTALLED_DATE>
<LAST_REBOOT>@@__m_operatingSystemLastBootupTime__@@</LAST_REBOOT>
<LAST_SHUTDOWN>@@__m_operatingSystemLastBootupTime__@@</LAST_SHUTDOWN>
<UPTIME>@@__m_operatingSystemUptime__@@</UPTIME>
<SYSTEM_DIRECTORY>@@__m_operatingSystemWindowsDirectory__@@</SYSTEM_DIRECTORY>
<SYSTEM_DESCRIPTION>@@__m_operatingSystemDescription__@@</SYSTEM_DESCRIPTION>
<RAM_TOTAL>@@__m_physicalMemoryTotalSize__@@</RAM_TOTAL>
<RAM_USED>@@__m_operatingSystemUsedPhysicalMemory__@@</RAM_USED>
<CS_MANUFACTURER>@@__m_computerSystemManufacturer__@@</CS_MANUFACTURER>
<CS_MODEL>@@__m_computerSystemModel__@@</CS_MODEL>
<CHASSIS_TYPE>@@__m_systemEnclosureChassisType__@@</CHASSIS_TYPE>
<TZ_AGENT>@@__m_versionTimeZone__@@</TZ_AGENT>
<USER_LOGGED>@@__m_computerSystemUserName__@@</USER_LOGGED>
<CS_DOMAIN>@@__m_computerSystemDomain__@@</CS_DOMAIN>
<USER_NAME>@@__m_userAccountName__@@</USER_NAME>
<USER_DOMAIN>@@__m_userAccountDomain__@@</USER_DOMAIN>
<BIOS_NAME>@@__m_biosName__@@</BIOS_NAME>
<BIOS_VERSION>@@__m_biosVersion__@@</BIOS_VERSION>
<BIOS_MANUFACTURER>@@__m_biosManufacturer__@@</BIOS_MANUFACTURER>
<BIOS_DESCRIPTION>@@__m_biosDescription__@@</BIOS_DESCRIPTION>
<BIOS_SERIAL_NUMBER>@@__m_biosSerialNumber__@@</BIOS_SERIAL_NUMBER>
<MOTHERBOARD_PRIMARY_BUS>@@__m_motherboardDevicePrimaryBusType__@@
</MOTHERBOARD_PRIMARY_BUS>
<MOTHERBOARD_SECONDARY_BUS>@@__m_motherboardDeviceSecondaryBusType__@@
</MOTHERBOARD_SECONDARY_BUS>
<PROCESSORS>CPU Chip Count: @@__m_processorCount__@@
CPU Core Count: @@__m_processorCoreCount__@@
@@__m_processorList__@@ </PROCESSORS>
<SOUND_DEVICES>@@__m_soundDeviceDescription__@@</SOUND_DEVICES>
<CDROM_DEVICES>@@__m_CDROMDeviceName__@@</CDROM_DEVICES>
<VIDEO_CONTROLLERS>@@__m_videoControllerName__@@</VIDEO_CONTROLLERS>
<REGISTRY_SIZE>@@__m_registryCurrentSize__@@</REGISTRY_SIZE>
<REGISTRY_MAX_SIZE>@@__m_registryMaximumSize__@@</REGISTRY_MAX_SIZE>
<DISK_DRIVES>
@@__m_logicalDiskDriveList__@@ </DISK_DRIVES>
<NETWORK_INTERFACES>
@@__m_networkAdapterConfigurationList__@@ </NETWORK_INTERFACES>
<PRINTERS>@@__m_printerList__@@</PRINTERS>
<STARTUP_PROGRAMS>
@@__m_startupProgramsList__@@ </STARTUP_PROGRAMS>
<PROCESSES>
@@__m_processList__@@ </PROCESSES>
<NT_SERVICES>
@@__m_servicesList__@@ </NT_SERVICES>
<INSTALLED_software>
@@__m_installedProgramsList__@@ </INSTALLED_software>
<CLIENT_VERSION>@@__m_appVersion__@@</CLIENT_VERSION>
</MachineStruct>
WindowsデバイスでのXMLスキーマの使用例

Windowsデバイスの有効なXMLスキーマに適合するファイル例を表示できます。

以下は、Windowsに有効なXMLスキーマに示されているスキーマを使用した有効な XML の例です。


<?xml version="1.0" encoding="utf-8"?>
<MachineStruct xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<NAME>TestComputer</NAME>
<IP>10.10.10.10</IP>
<MAC>F1234567-C2D2-4055-85BB-294E6A3D22D9</MAC>
<OS_NAME>Microsoft Windows 7 Professional</OS_NAME>
<OS_NUMBER>6.1.7601.17514</OS_NUMBER>
<OS_MAJOR>6</OS_MAJOR>
<OS_MINOR>1</OS_MINOR>
<SERVICE_PACK>Service Pack 1</SERVICE_PACK>
<USER>Administrator</USER>
<USER_FULLNAME>Tom Silver</USER_FULLNAME>
<DOMAIN>WORK</DOMAIN>
<OS_VERSION>6.1.7601</OS_VERSION>
<OS_BUILD>17514</OS_BUILD>
<OS_INSTALLED_DATE>2017-08-30 14:22:39 -0400</OS_INSTALLED_DATE>
<LAST_REBOOT>2017-08-30 14:25:05 -0400</LAST_REBOOT>
<LAST_SHUTDOWN>2017-08-30 14:25:05 -0400</LAST_SHUTDOWN>
<UPTIME>4 days </UPTIME>
<SYSTEM_DIRECTORY>C:\WINDOWS</SYSTEM_DIRECTORY>
<SYSTEM_DESCRIPTION>Windows 7 Machine</SYSTEM_DESCRIPTION>
<RAM_TOTAL>512.00MB</RAM_TOTAL>
<RAM_USED>180MB</RAM_USED>
<CS_MANUFACTURER>VMware, Inc.</CS_MANUFACTURER>
<CS_MODEL>VMware Virtual Platform</CS_MODEL>
<CHASSIS_TYPE>Other</CHASSIS_TYPE>
<USER_LOGGED>Tom</USER_LOGGED>
<CS_DOMAIN>WORK</CS_DOMAIN>
<USER_NAME>Administrator</USER_NAME>
<USER_DOMAIN>Work</USER_DOMAIN>
<BIOS_NAME>PhoenixBIOS 4.0 Release 5.5 </BIOS_NAME>
<BIOS_VERSION>INTEL - 6040000</BIOS_VERSION>
<BIOS_MANUFACTURER>Phoenix Technologies LTD</BIOS_MANUFACTURER>
<BIOS_DESCRIPTION>PhoenixBIOS 4.0 Release 5.5 </BIOS_DESCRIPTION>
<BIOS_SERIAL_NUMBER>VMware-56 4d bd d3 5e 4f a5 4e-6a ce a0 d3 39 bd ae 02
</BIOS_SERIAL_NUMBER>
<MOTHERBOARD_PRIMARY_BUS>PCI</MOTHERBOARD_PRIMARY_BUS>
<MOTHERBOARD_SECONDARY_BUS>ISA</MOTHERBOARD_SECONDARY_BUS>
<PROCESSORS>CPU Chip Count: 1
CPU Core Count: 0
CPU0: Intel Celeron processor (0 cores) </PROCESSORS>
<SOUND_DEVICES>Creative AudioPCI (ES1371,ES1373) (WDM)
</SOUND_DEVICES>
<CDROM_DEVICES>TSSTcorp DVD+-RW TS-U633F
</CDROM_DEVICES>
<VIDEO_CONTROLLERS>VMware SVGA II
</VIDEO_CONTROLLERS>
<REGISTRY_SIZE>1MB</REGISTRY_SIZE>
<REGISTRY_MAX_SIZE>86MB</REGISTRY_MAX_SIZE>
<DISK_DRIVES>
<DiskDrive>
<NAME>Drive C: (Physical Disk) FileSystem: NTFS Used: 2.08GB Total: 39.99GB</NAME>
<DISK_SIZE>39.9906</DISK_SIZE>
<DISK_USED>2.07966</DISK_USED>
<DISK_FREE>37.9109</DISK_FREE>
<PERCENT_USED>5.2</PERCENT_USED>
</DiskDrive>
</DISK_DRIVES>
<NETWORK_INTERFACES>
<NetworkInterface>
<NIC>AMD PCNET Family PCI Ethernet Adapter - Packet Scheduler
Miniport</NIC>
<MAC>00:0C:29:BD:AE:03</MAC>
<IP>192.168.220.132</IP>
<DHCP_ENABLED>True</DHCP_ENABLED>
</NetworkInterface>
</NETWORK_INTERFACES>
<PRINTERS></PRINTERS>
<STARTUP_PROGRAMS>
<StartupProgram>
<NAME>desktop</NAME>
</StartupProgram>
<StartupProgram>
<NAME>VMware Tools</NAME>
<COMMAND_EXE>C:\Program Files\VMware\VMware Tools\VMwareTray.exe</COMMAND_EXE>
<COMMAND_ARGS />
<FILE_INFO>
<FILE_NAME>VMwareTray.exe</FILE_NAME>
<FILE_DESCRIPTION>VMware Tools tray application</FILE_DESCRIPTION>
<FILE_VERSION>8.4.6.16648</FILE_VERSION>
<PRODUCT_NAME>VMware Tools</PRODUCT_NAME>
<PRODUCT_VERSION>8.4.6 build-385536</PRODUCT_VERSION>
<COMPANY_NAME>VMware, Inc.</COMPANY_NAME>
</FILE_INFO>
</StartupProgram>
<StartupProgram>
<NAME>VMware User Process</NAME>
<COMMAND_EXE>C:\Program Files\VMware\VMware Tools\VMwareUser.exe</COMMAND_EXE>
<COMMAND_ARGS />
<FILE_INFO>
<FILE_NAME>VMwareUser.exe</FILE_NAME>
<FILE_DESCRIPTION>VMware Tools Service</FILE_DESCRIPTION>
<FILE_VERSION>8.4.6.16648</FILE_VERSION>
<PRODUCT_NAME>VMware Tools</PRODUCT_NAME>
<PRODUCT_VERSION>8.4.6 build-385536</PRODUCT_VERSION>
<COMPANY_NAME>VMware, Inc.</COMPANY_NAME>
</FILE_INFO>
</StartupProgram>
</STARTUP_PROGRAMS>
<PROCESSES>
<MachineProcess>
<NAME>konea.exe</NAME>
<COMMAND_EXE>C:\Program Files (x86)\Quest\KACE\konea.exe</COMMAND_EXE>
<COMMAND_ARGS/>
<FILE_INFO>
<FILE_NAME>konea.exe</FILE_NAME>
<FILE_DESCRIPTION>konea</FILE_DESCRIPTION>
<FILE_VERSION>255.239.6</FILE_VERSION>
<PRODUCT_NAME>KACE Agent</PRODUCT_NAME>
<PRODUCT_VERSION>255.239.6</PRODUCT_VERSION>
<COMPANY_NAME>Quest Software Inc.</COMPANY_NAME>
</FILE_INFO>
</MachineProcess>
</PROCESSES>
<NT_SERVICES>
<NtService>
<NAME>Alerter</NAME>
<DISPLAY_NAME>Alerter</DISPLAY_NAME>
<STATUS>SERVICE_STOPPED</STATUS>
<STARTUP_TYPE>SERVICE_DISABLED</STARTUP_TYPE>
<DESCRIPTION />
<LOGON_AS_USER>NT AUTHORITY\LocalService</LOGON_AS_USER>
<CAN_INTERACT_WITH_DESKTOP>False</CAN_INTERACT_WITH_DESKTOP>
<COMMAND_EXE>C:\WINDOWS\system32\svchost.exe</COMMAND_EXE>
<COMMAND_ARGS> -k LocalService</COMMAND_ARGS>
<FILE_INFO>
<FILE_NAME>svchost.exe</FILE_NAME>
<FILE_DESCRIPTION>Generic Host Process for Win32 Services</FILE_DESCRIPTION>
<FILE_VERSION>6.1.7600.16385 (win7_rtm.090713-1255)</FILE_VERSION>
<PRODUCT_NAME>Microsoft?? Windows?? Operating System</PRODUCT_NAME>
<PRODUCT_VERSION>6.1.7600.16385</PRODUCT_VERSION>
<COMPANY_NAME>Microsoft Corporation</COMPANY_NAME>
</FILE_INFO>
</NtService>
</NT_SERVICES>
<INSTALLED_software>
<software>
<DISPLAY_VERSION>5.2.38916</DISPLAY_VERSION>
<HELP_LINK />
<README />
<INSTALL_DATE>20170830</INSTALL_DATE>
<PUBLISHER>Quest Software Inc.</PUBLISHER>
<UNINSTALL_STRING />
<URLINFO_ABOUT />
<DISPLAY_NAME>Quest KACE Agent</DISPLAY_NAME>
</software>
</INSTALLED_software>
<CLIENT_VERSION>8.0.xxxxx</CLIENT_VERSION>
</MachineStruct>
LinuxおよびMacデバイスに有効なXMLスキーマ

LinuxおよびMacデバイスのインベントリ情報のアップロードに使用されるファイルは、有効なXMLスキーマを使用する必要があります。

以下は、LinuxおよびMacデバイス向けのXMLスキーマの例です。


<?xml version="1.0" encoding="utf-8"?>
<MachineStruct>
<NAME>@@__m_versionHostName__@@</NAME>
<CLIENT_VERSION>@@__m_appVersion__@@</CLIENT_VERSION>
<IP>@@__m_IPAddress__@@</IP>
<MAC>@@__m_versionKaceId__@@</MAC>
<OS_NAME>@@__m_operatingSystemCaption__@@</OS_NAME>
<OS_NUMBER>@@__m_operatingSystemVersion__@@</OS_NUMBER>
<OS_MAJOR>@@__m_operatingSystemVersionMajor__@@</OS_MAJOR>
<OS_MINOR>@@__m_operatingSystemVersionMinor__@@</OS_MINOR>
<SERVICE_PACK></SERVICE_PACK>
<INSTALL_DATE></INSTALL_DATE>

<OS_ARCH>@@__m_operatingSystemOSArchitecture__@@</OS_ARCH>
<OS_FAMILY>@@__m_operatingSystemOSFamily__@@</OS_FAMILY>
<OS_VERSION>@@__m_operatingSystemVersion__@@</OS_VERSION>
<OS_BUILD>@@__m_operatingSystemBuildNumber__@@</OS_BUILD>
<DOMAIN>@@__m_userAccountDomain__@@</DOMAIN>
<CS_DOMAIN>@@__m_userAccountDomain__@@</CS_DOMAIN>

<LAST_REBOOT>@@__m_operatingSystemLastBootupTime__@@</LAST_REBOOT>
<TZ_AGENT>@@__m_versionTimeZone__@@</TZ_AGENT>
<UPTIME>@@__m_operatingSystemUptime__@@</UPTIME>

<RAM_TOTAL>@@__m_operatingSystemTotalVisibleMemorySize__@@</RAM_TOTAL>
<RAM_USED>@@__m_operatingSystemUsedPhysicalMemory__@@</RAM_USED>
<CS_MANUFACTURER>@@__m_biosManufacturer__@@</CS_MANUFACTURER>
<CS_MODEL></CS_MODEL>
<USER_LOGGED>@@__m_userAccountName__@@</USER_LOGGED>
<USER>@@__m_userAccountName__@@</USER>
<USER_NAME>@@__m_userAccountName__@@</USER_NAME>
<USER_FULLNAME>@@__m_userAccountFullName__@@</USER_FULLNAME>
<USER_DOMAIN>@@__m_userAccountDomain__@@</USER_DOMAIN>
<BIOS_NAME>@@__m_biosName__@@</BIOS_NAME>
<BIOS_VERSION>@@__m_biosVersion__@@</BIOS_VERSION>
<BIOS_MANUFACTURER>@@__m_biosManufacturer__@@</BIOS_MANUFACTURER>
<BIOS_DESCRIPTION>@@__m_biosName__@@</BIOS_DESCRIPTION>
<BIOS_SERIAL_NUMBER>@@__m_biosSerialNumber__@@</BIOS_SERIAL_NUMBER>
<MOTHERBOARD_PRIMARY_BUS></MOTHERBOARD_PRIMARY_BUS>
<MOTHERBOARD_SECONDARY_BUS></MOTHERBOARD_SECONDARY_BUS>
<PROCESSORS>@@__m_processorList__@@</PROCESSORS>
<SOUND_DEVICES>@@__m_soundDeviceDescription__@@</SOUND_DEVICES>
<CDROM_DEVICES>@@__m_CDROMDeviceName__@@</CDROM_DEVICES>
<MONITOR>@@__m_desktopMonitorDescription__@@</MONITOR>

<VIDEO_CONTROLLERS>@@__m_videoControllerName__@@</VIDEO_CONTROLLERS>
<DISK_DRIVES>
@@__m_logicalDiskDriveList__@@</DISK_DRIVES>
<NETWORK_INTERFACES>
@@__m_networkAdapterConfigurationList__@@</NETWORK_INTERFACES>
<PRINTERS>@@__m_printerList__@@</PRINTERS>
<STARTUP_PROGRAMS>
@@__m_startupProgramsList__@@</STARTUP_PROGRAMS>
<PROCESSES>
@@__m_processList__@@</PROCESSES>
<INSTALLED_software>
@@__m_installedProgramsList__@@</INSTALLED_software>
</MachineStruct>
管理者コンソールを使用した XML ファイルのアップロード

管理者コンソールを使用して、デバイスのインベントリ情報が含まれた XML ファイルをアップロードできます。このタイプの情報は、手動インベントリ情報と呼ばれます。

KACE エージェントが、インベントリ情報が追加されたデバイスにインストールされています。

インベントリに追加されるデバイスで XML ファイルを作成し、アプライアンスに移動してこのファイルをアップロードします。

手動インベントリ情報は ソフトウェア ページに表示されますが、ソフトウェアカタログ ページには表示されません。詳細については、以下を参照してください。

•
ソフトウェア ページでのアプリケーション管理
•
ソフトウェアカタログインベントリの管理
1.
情報が含まれるXMLファイルを生成します。
a.
KACE エージェントがインストールされているデバイス上で、コマンドプロンプトまたはターミナルウィンドウを開きます。
b.
Quest KACEのインストールディレクトリに移動します。
例：
▪
Windows 32ビットシステム：C:\Program Files\Quest\KACE
▪
Windows 64ビットシステム：C:\Program Files (x86)\Quest\KACE
▪
Mac OS Xシステム：/Library/Application Support/Quest/KACE/bin
▪
Linuxシステム：/opt/quest/kace/bin
c.
次のコマンドを入力します:
KInventory -machine -output filename

ここでのfilenameは、作成するXMLファイルへのパスです。パスにスペースが含まれる場合は、二重引用符でパス全体を囲みます。

エージェントでインベントリデータが収集され、XMLファイルが生成されます。

2.
アプライアンスの管理者コンソールで、デバイス リストに移動します。
a.
アプライアンス管理者コンソール（https://appliance_hostname/admin）にログインします。または、管理ヘッダーに組織メニューを表示 オプションがアプライアンスの 一般設定 で有効になっている場合は、ページの右上隅で、ログイン情報の横にあるドロップダウンリストから組織を選択します。
b.
左側のナビゲーションバーで、インベントリ をクリックして、ダッシュボード をクリックします。
3.
アクションの選択 > 新規作成 > 手動登録デバイスを選択して、デバイスの詳細 ページを表示します。
4.
Import Device（デバイスのインポート） で、参照 をクリックします。
5.
ファイルを選択し、開く または 選択 をクリックします。
6.
保存 をクリックします。

デバイスの情報がインベントリに追加されます。XMLファイルをアップロードした場合、アプライアンスによりページ上の他のすべての情報が無視され、インベントリ情報にXMLファイルが使用されます。

関連ドキュメント

The document was helpful.

評価を選択

I easily found the information I needed.

評価を選択