サポート (英語のみ)

Windows用のCollector設定ツール

概要

Nxtcfgは、小さなコンソールアプリケーションで、コレクターの設定パラメーターの読み取りと修正を行います。 管理者権限でNxtcfgを実行します。

インストール

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

C:\Windows\System32\nxtcfg.exe

必要ない場合、コレクターをインストールする際のMSIコマンドラインにオプションCFG_INSTALL=0を追加します。

オプション

オプション
説明
例

/start

コレクターを開始します。

nxtcfg.exe /start

/stop

コレクターを停止します。

nxtcfg.exe /stop

/restart

コレクターを再起動します。

nxtcfg.exe /restart

/g

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

nxtcfg.exe /g ip

/s

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

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

/l

現在の値とともに、コレクターのすべての設定パラメーターを一覧表示します。

nxtcfg.exe /l

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

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

+ ファイル著作権 (C) 2004 - 2019 Nexthink S.A. All rights reserved.
+ nxtcfg.exe - Nexthinkコレクターの設定を変更します。
+ バージョン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 was completed successfully.

設定パラメータ

一部のパラメータを変更するには、Collectorを再起動すると全ての変更が適用されます。 デバイスを再起動すると、全てのCollectorコンポーネントが強制的に再起動されます。 それぞれのパラメータについて、パラメータ表の再起動が必要列の値で指定されています。

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

  • はい\nCollectorの再起動またはデバイスの再起動が必要です。

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

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

ログが有効の場合のログファイルの最大サイズ。 最大に達した時、ログは回転されます。

32MB

[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はWebおよびクラウドデータを報告します。

1

[0 - 1]

あり

wm_domains

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

-

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

いいえ

prefer_ipv6

設定すると、CollectorはFQDNがIPv6およびIPv4アドレス両方で解決された場合、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以外のデバイスでエンドユーザーと連携する機能を有効化します。

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

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

  • エンドユーザーとの関与を促進するために、機能を有効にしてください。

あり

data_over_tcp

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

有効

  • 無効 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を直接停止または再起動すると、CollectorとNexthinkインスタンス間の通信が途絶え、Collectorがリモートアクションに関する状態を失います。 Collectorが再起動すると、リモートアクションを先頭から実行し始めるため、無限ループを引き起こす可能性があります。

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

  • Collectorを停止する:

  • Collectorを起動する:

カスタマーキーの設定

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

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

カスタマーキーとルート証明書を設定するには、次のコマンドを入力します:

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

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

関連タスク

Last updated

Was this helpful?