Windows用コレクター設定ツール

概要

Nxtcfgは、Collectorの設定パラメータを読み取り、変更する小さなコンソールアプリケーションです。 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

Collectorから特定の設定パラメータの値を取得します。次のセクションの表で可能なパラメータの一覧を参照してください。

nxtcfg.exe /g ip

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

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

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] [INFO] 接続中
execution_policy=signed_trusted_or_nexthink
printing=無効
assignment_status=割り当て済み
engage=サーバーOS以外で無効
use_assignment=有効
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コンポーネントも強制的に再起動します。各パラメータについて、パラメータの表の再起動の必要性列に指定されています:

いいえ 再起動やコンポーネントの再スタートは不要です。
はい Collectorの再起動またはデバイスの再起動が必要です。

パラメータ

説明

デフォルト値

範囲

再起動の必要性

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

いいえ

tcp_port

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

[1024 - 65535]

はい

tag

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

[0 - 2147483647]

いいえ

string_tag

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

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

いいえ

cgpi

CrashGuard保護間隔値は、ブート後（分単位）に汚い再起動や自発的なシステム再起動がCrashGuardを増加させない時間間隔です。

240 分

はい

logmode

ロギングモード:

0 - サイレント
1 - 詳細
2 - デバッグ（本番環境では推奨されません）

[0 - 2]

いいえ

logsize

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

32 MB

[1 - 512] MB

はい

iops

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

[0 - 1]

はい

dwef

設定されると、Collectorはアプリケーションがフリーズしたり反応しなくなったことを報告しません。

[0 - 1]

はい

pkg_interval

Collectorが新しくインストールされたパッケージと更新を確認し、報告する期間（時間単位）:

0 - パッケージを報告しません。
1 - Collectorの初期化後とその後毎時報告します。
2-24 - Collectorの初期化後45分後に報告され、その後2から24時間ごとに報告されます。

[0 - 24]

はい

wme

（クラシック）設定されると、Collectorはwebおよびcloudデータを報告します。

[0 - 1]

はい

wm_domains

（クラシック）webリクエストのURLを報告するドメインのリスト。

カンマ区切りのドメイン名

いいえ

prefer_ipv6

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

[0 - 1]

いいえ

custom_shells

設定されると、Explorerがデフォルトのシェルでない環境でユーザーのログオンイベントを報告するためにCollectorを有効にします。例えば、特定の組み込み（キオスクモード）または仮想化環境。

[0 - 1]

いいえ

execution_policy

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

signed_trusted_or_nexthink

disabled
signed_trusted
signed_trusted_or_nexthink
unrestricted

いいえ

customer_key

Nexthinkインスタンスの顧客キー。

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

はい

assignment_status

（クラシック）Collectorの割り当てステータス。

disabled

disabledCollectorはAssignment Serviceを使用していません。
standbyCollector is awaiting assignment to an Engine.エンジンへの割り当てを待っています。
assignedCollectorがエンジンに割り当てられています。

いいえ（読み取り専用）

use_assignment

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

無効化

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

はい (有効化時のみ)

参加

従業員と関わる機能の有効化。

サーバーOS以外で有効化

server OS以外のデバイスで、エンドユーザーと関わる機能を有効にします。
無効化エンドユーザーと関わる機能を無効にします。
有効化エンドユーザーと関わる機能を有効にします。

はい

データ_over_TCP

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

有効化

無効化 Nexthink cloud インスタンスではもう可能ではありません。
有効化エンドユーザーデータを 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

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

代わりに、再起動が必要なリモートアクションから 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 は、TLS を介して Nexthink インスタンスのアイデンティティを確認し、安全に通信するために顧客キーを使用します。このセキュリティパラメータが変更された場合は、Collector インスタンスの設定を調整する必要があります。

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

顧客キーとルート証明書を設定するには、次のコマンドを入力してください:

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

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