学ぶ (英語版)
ドキュメント (英語版)
サポート (英語のみ)
コミュニティ (英語版)

Windows用Collector設定ツール

概要

Nxtcfgは小さなコンソールアプリケーションであり、Collectorの構成パラメーターを読み取り、変更します。 管理者権限でNxtcfgを実行してください。

インストール

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

C:\Windows\System32\nxtcfg.exe

If not required, add the option CFG_INSTALL=0 to the MSI command line when installing the Collector.

オプション

オプション
説明
例

/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 [Version 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 - Changes the configuration of the Nexthink Collector.
+ version 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=not set
dsps=1
iops=1
prefer_ipv6=0
pkg_interval=1
custom_shells=0
customer_key=-----BEGIN CUSTOMER KEY-----docs [truncated] docs-----END CUSTOMER KEY-----
root_ca=-----BEGIN CERTIFICATE-----docs [truncated] docs==-----END CERTIFICATE-----
clt_state=functioning_properly
traffic_status=317 packets sent (341834 bytes)
tcp_status=[26.08.2022 09:11:28.439] [INFO] Connected
execution_policy=signed_trusted_or_nexthink
printing=disable
assignment_status=assigned
engage=enable_except_on_server_os
use_assignment=enable
data_over_tcp=enable
proxy_address=not set
proxy_port=not set
proxy_pac_address=not set
mtls_fingerprint=not set
mtls_issuer_common_name=not set
mtls_subject_common_name=not set
install_browser_extension=not set
nxtcfg.exe completed successfully.

構成パラメーター

一部のパラメーターの変更には、すべての変更を適用するためにCollectorの再起動が必要です。 デバイスの再起動は、すべてのCollectorコンポーネントを強制的に再起動します。 各パラメーターに対して、パラメーターテーブルの再起動が必要列の値で指定されています：

  • No 再起動またはコンポーネントの再起動は必要ありません。

  • Yes Collectorの再起動またはデバイスの再起動が必要です。

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

ip

あなたのNexthinkインスタンスの完全修飾ドメイン名（FQDN）。

-

-

いいえ

tcp_port

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

-

[1024 - 65535]

はい

tag

インストールを識別するための任意の整数番号。

0

[0 - 2147483647]

いいえ

string_tag

インストールを識別するための任意のラベル。

-

任意の文字列（最大2048文字）

いいえ

cgpi

CrashGuard保護間隔値は、起動後の一定の時間（分）で、汚れた再起動、つまり自発的なシステム再起動がCrashGuardを増加させない時点です。

240分

-

はい

logmode

ログモード：

  • 0 - サイレント

  • 1 - 詳細

  • 2 - デバッグ（本番環境では推奨されません）

0

[0 - 2]

いいえ

logsize

ログが有効な場合の最大ログファイルサイズ。 最大に達するとログがローテーションされます。

32 MB

[1 - 512] MB

はい

iops

IOPS監視機能を有効（1）または無効（0）にします。

0

[0 - 1]

はい

dwef

設定されている場合、Collectorはアプリケーションがフリーズしたり応答を停止したりした際に報告しません。

0

[0 - 1]

はい

pkg_interval

Collectorが新しくインストールされたパッケージと更新をチェックし、報告する時間間隔（時間単位）：

  • 0 - パッケージを報告しない。

  • 1 - Collectorが初期化された後にパッケージを報告し、以後1時間ごとに報告します。

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

1

[0 - 24]

はい

wme

（クラシック）セットされている場合、CollectorはWebおよびCloudデータを報告します。

1

[0 - 1]

はい

wm_domains

（クラシック）webリクエストの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はEngineへの割り当てを待っています。

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

いいえ（読み取り専用）

use_assignment

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

無効化

  • Assignment Serviceを使用しないようCollectorに指示します。

  • Assignment Serviceを使用するようCollectorに指示します。

はい（有効化時のみ）

エンゲージ

従業員と関わるための機能を有効にします。

enable_except_on_server_os

  • serverタイプのOSを実行しているデバイスを除いて、エンドユーザーと関わるための機能を有効にします。

  • 無効エンドユーザーと関わるための機能を無効にします。

  • 有効エンドユーザーと関わるための機能を有効にします。

はい

data_over_tcp

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

有効

  • 無効 Nexthink cloudインスタンスではこれ以上不可能です。

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

はい

proxy_pac_address

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

-

  • PACファイルのURL

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

はい

proxy_address

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

-

  • プロキシのアドレス。

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

はい

proxy_port

プロキシ設定を手動で構成するためにプロキシが待ち受けを行っているポート番号。

-

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

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

はい

リモートアクションでのNxtcfg

CollectorはRemote Actionsを実行する際にNexthinkインスタンスと通信するため、リモートアクションからCollectorの設定パラメーターを変更することはお勧めしません。 したがって、リモートアクション内でnxtcfg.exeを実行するときに、以下の設定パラメーターを変更しないでください：

  • ip

  • tcp_port

  • customer_key

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

ただし、リモートアクションからCollectorの設定を変更する必要があり、再起動が必要な場合は、リモートアクションのスクリプト内で次のコードを使用します：

  • Collectorを停止する：

Stop-Service -Name "Nexthink Service" -Force
Stop-Service -Name "nxtrdrvwfp" -Force
Stop-Service -Name "nxtrdrv" -Force

  • Collectorを開始する：

Start-Service -Name "nxtrdrv"
Start-Service -Name "nxtrdrvwfp"
Start-Service -Name "Nexthink Service"

お客様のキーの設定

Collectorはお客様のキーを使用してNexthinkインスタンスの認証を行い、TLSを介して安全に通信します。 そのセキュリティパラメーターが変更された場合は、すべてのCollectorインスタンスの設定を調整する必要があります。

パラメーターcustomer_keyは特別で、直接的な値を引数としてではなく、実際の値を保持するテキストファイルへのパスとして指定されます。

お客様のキーとルート証明書を設定するには、次のコマンドを入力します：

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

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

関連するタスク

Last updated

Was this helpful?