サポート (英語のみ)

Windows用のCollector設定ツール

概要

Nxtcfgは小規模なコンソール・アプリケーションで、コレクタの構成パラメータを読み取って修正します。 管理者権限でNxtcfgを実行します。

インストール

デフォルトでは、NxtcfgツールはCollectorのMSIをインストールする際にCollectorと共にインストールされます。 絶対ファイルパスはこちらです:

C:\Windows\System32\nxtcfg.exe

必要がない場合は、Collectorをインストールする時にMSIコマンドラインにCFG_INSTALL=0を追加してください。

オプション

オプション
説明
例

/start

Collectorを開始します。

nxtcfg.exe /start

/stop

Collectorを停止します。

nxtcfg.exe /stop

/restart

Collectorを再起動します。

nxtcfg.exe /restart

/g

特定の構成パラメータの値をCollectorから取得します。 可能なパラメータのリストは次のセクションの表を参照してください。

nxtcfg.exe /g ip

/s

Collectorの1つまたは複数の構成パラメータの値を設定します。 可能なパラメータのリストは次のセクションの表を参照してください。

nxtcfg.exe /s ip=nxdocs.data.eu.nexthink.cloud tcp_port=443

/l

現在の値と共にCollectorのすべての構成パラメータをリストします。

nxtcfg.exe /l

ローカル管理者によるインストール版番号を確認するために使用する、/lオプションの出力例です。
Microsoft Windows [バージョン 10.0.19042.1766]
(c) Microsoft Corporation. All rights reserved.

C:\WINDOWS\system32>nxtcfg.exe /l

+ Copyright (C) 2004 - 2019 Nexthink S.A. All rights reserved.
+ nxtcfg.exe - Nexthink Collectorの構成を変更します。
+ バージョン 22.4.6.9

ip=nxdocs.data.eu.nexthink.com (::1)
udp_port=2001
tcp_port=443
tag=0
string_tag="default_string_tag"
cgpi=240
logmode=2
logsize=1
dwef=0
mss=1224
wme=1
wm_domains=設定なし
dsps=1
iops=1
prefer_ipv6=0
pkg_interval=1
custom_shells=0
customer_key=-----BEGIN CUSTOMER KEY-----docs [省略] docs-----END CUSTOMER KEY-----
root_ca=-----BEGIN CERTIFICATE-----docs [省略] docs==-----END CERTIFICATE-----
clt_state=正常に動作中
traffic_status=317個のパケットが送信されました (341834バイト)
tcp_status=[26.08.2022 09:11:28.439] [情報] 接続完了
execution_policy=signed_trusted_or_nexthink
printing=無効
assignment_status=割り当て済み
engage=サーバーOSでは無効
data_over_tcp=有効
proxy_address=設定なし
proxy_port=設定なし
proxy_pac_address=設定なし
mtls_fingerprint=設定なし
mtls_issuer_common_name=設定なし
mtls_subject_common_name=設定なし
install_browser_extension=設定なし
nxtcfg.exeは正常に完了しました。

構成パラメータ

いくつかのパラメータを変更するには、Collectorを再起動する必要があります。すべての変更を有効にするためには再起動してください。 デバイスを再起動すると、すべてのコレクタ構成要素も強制的に再起動されます。 各パラメータについては、パラメータ表の再起動の必要性の列で指定されています:

  • いいえ 再起動や構成要素の再起動は必要ありません。

  • はい Collectorの再起動やデバイスの再起動が必要です。

パラメータ
説明
デフォルト値
範囲
再起動の必要性

ip

Nexthinkインスタンスの完全修飾ドメイン名(FQDN)。

-

-

いいえ

tcp_port

NexthinkインスタンスとのTCP通信のためのポート番号。

-

[1024 - 65535]

あり

tag

インストールを識別するためのオプション整数。

0

[0 - 2147483647]

いいえ

string_tag

インストールを識別するためのオプションラベル。

-

任意の文字列(最大2048文字)

いいえ

cgpi

クラッシュガード保護間隔の値は、汚いリブートまたは自発的なシステム再起動後の、クラッシュガードを増加させない起動後の時間間隔(分)です。

240分

-

あり

logmode

ログモード:

  • 0 - サイレント

  • 1 - 詳細表示

  • 2 - デバッグ (本番環境では推奨しません)

0

[0 - 2]

いいえ

logsize

ロギングが有効化されたときのログファイルの最大サイズ。 最大に達したらログは回転されます。

32 MB

[1 - 512] MB

あり

dpsp

SMBプリント監視サブ機能の無効(1)または有効(0)。

1

[0 - 1]

あり

iops

IOPSモニタリング機能の有効(1)または無効(0)。

0

[0 - 1]

あり

dwef

設定した場合、アプリケーションがフリーズまたは応答しなくなったときにCollectorは報告しません。

0

[0 - 1]

あり

pkg_interval

Collectorが新しくインストールされたパッケージと更新をチェックして報告する時間の期間(時間):

  • 0 - パッケージを報告しません。

  • 1 - 初期化の後にCollectorがパッケージを報告し、毎時間報告を行います。

  • 2-24 - Collector初期化の45分後にパッケージを報告し、2〜24時間ごとに報告します。

1

[0 - 24]

あり

wme

(クラシック) 設定した場合、Collectorはウェブとクラウドのデータを報告します。

1

[0 - 1]

あり

wm_domains

(クラシック) ウェブリクエストのURLを報告するドメインのリスト。

-

カンマで区切られたドメイン名

いいえ

prefer_ipv6

設定した場合、FQDNがIPv6とIPv4の両方に解決されるときに、CollectorはIPv6を優先してNexthinkインスタンスと通信します。

0

[0 - 1]

いいえ

custom_shells

設定した場合、Explorerがデフォルトのシェルでない環境でのユーザーログオンイベントをCollectorが報告できるようにします。 例えば、特定の組み込み(キオスクモード)または仮想化環境です。

0

[0 - 1]

いいえ

execution_policy

リモートアクションのスクリプトを実行するときに適用するセキュリティポリシー。

signed_trusted_or_nexthink

  • 無効

  • signed_trusted

  • signed_trusted_or_nexthink

  • 無制限

いいえ

customer_key

Nexthinkインスタンスのカスタマーキー。

-

暗号鍵が記載されたテキストファイルへのパス。

あり

assignment_status

(クラシック) Collectorの割り当て状況。

無効

  • 無効Collectorは割り当てサービスを使用していません。

  • 待機中Collectorはエンジンへの割り当てを待っています。

  • 割り当て済みCollectorはエンジンに割り当てられています。

いいえ (読取り専用)

use_assignment

(クラシック) Collectorに割り当てサービスを使用するかしないか指示します。

無効化

  • 無効化Collectorに割り当てサービスを使用しないように指示します。

  • 有効化Collectorに割り当てサービスを使用するように指示します。

はい (有効化時のみ)

engage

従業員との連携機能を有効化します。

サーバーOSでは有効化しない

  • サーバータイプのOSを実行しているデバイスを除くエンドユーザーと連携するための機能を有効化します。

  • 無効化エンドユーザーと連携するための機能を無効化します。

  • 有効化エンドユーザーと連携するための機能を有効化します。

あり

data_over_tcp

TCP上でCollectorデータを送信します。

有効化

  • 無効化 Nexthinkクラウドインスタンスにはもう可能ではありません。

  • 有効化 エンドユーザーデータをTCPチャネルで送信します。

あり

proxy_pac_address

プロキシ設定を自動的に構成するPACファイルのURL。

-

  • PACファイルのURL

  • "" PACファイルを使用しない

あり

proxy_address

プロキシ設定を手動で構成するためのプロキシのFQDN。

-

  • プロキシのアドレス。

  • "" 手動プロキシ設定を使用しない。

あり

proxy_port

プロキシが手動設定のためにリスニングしているポート番号。

-

  • <ポート番号> プロキシのポート番号。

  • "" 手動プロキシ設定を使用しない。

あり

リモートアクションにおけるNxtcfg

Collectorはリモートアクションを実行する際、Nexthinkインスタンスと通信するので、リモートアクションからCollectorの構成パラメータを変更することは推奨されません。 したがって、リモートアクション内で nxtcfg.exe を実行するときは、以下の構成パラメータの変更を控えてください：

  • ip

  • tcp_port

  • customer_key

同じ理由で、リモートアクションを使用して nxtcfg.exe でCollectorを停止したり再起動したりしないでください。 Collectorを直接停止したり再起動したりすると、Nexthinkインスタンスとの通信が突然終了し、Collectorはリモートアクションに関連してその状態を失います。 Collectorが再起動されると、リモートアクションを最初から実行し始め、無限ループを引き起こす可能性があります。

代わりに、再起動が必要なリモートアクションから一部のCollector設定を変更する必要がある場合は、リモートアクションのスクリプトに以下のコードを使用してください：

  • Collectorを停止するには：

  • Collectorを開始するには：

カスタマキーの設定

Collectorは、NexthinkインスタンスのIDを確認し、TLSで安全に通信するためにカスタマキーを使用します。 このセキュリティパラメータが変更された場合、Collectorインスタンスの構成を調整する必要があります。

パラメータ customer_key は、直接の値を引数として認めないため、カスタマキーの実際の値を含むパスとして解釈されます。

カスタマキーとルート証明書を設定するには、以下のコマンドを入力してください：

nxtcfg.exe /s customer_key="C:\Nexthink-customer-key.txt" 上記の指示は、ファイルをC:ドライブのルートディレクトリに配置することを前提としています

Nxtcfgの /l オプションで customer_key パラメータをリスト表示すると、完全なカスタマキーは表示されません。 最初の数文字のみが表示されます。 これらの文字は通常、他のパラメータのリストを読みやすく保ちながらキーを識別するのに十分です。

関連タスク

Last updated

Was this helpful?