Windows用Collector設定ツール

概要

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

インストール

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

C:\Windows\System32\nxtcfg.exe

必要がない場合は、コレクターのインストール時にMSIコマンドラインにオプションCFG_INSTALL=0を追加してください。

オプション

オプション
説明

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

コレクターのすべての構成パラメーターを現在の値と共に一覧表示します。

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 - 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=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のすべてのコンポーネントが強制的に再起動されます。 各パラメーターについて、これはパラメーターテーブルの列再起動が必要にある値で指定されています。

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

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

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

IP

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

-

-

Non

tcp_port

Nexthink インスタンスとの TCP 通信に使用するポート番号。

-

[1024 - 65535]

Oui

tag

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

0

[0 - 2147483647]

Non

string_tag

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

-

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

Non

cgpi

CrashGuard 保護間隔値は、ブートからの(interval)(分数)後、アプリケーションの不意の再起動が CrashGuard を増幅させない時間間隔です。

240分

-

Oui

ログモード

ログモード:

  • 0 - サイレント

  • 1 - 詳細

  • 2 - デバッグ(運用環境には推奨されません)

0

[0 - 2]

Non

logmode

ロギングが有効な場合のログファイルの最大サイズ。 ログは最大容量に達した後にローテーションされます。

32 MB

[1 - 512] MB

Oui

IOPS

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

0

[0 - 1]

Oui

DWEF

設定されると、コレクタはアプリケーションがフリーズしたり反応しなくなっても報告しません。

0

[0 - 1]

Oui

pkg_interval

コレクタが新しくインストールしたパッケージと更新を確認できる期間(時間単位)を報告します。

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

  • 1 - コレクタが初期化された後にパッケージを報告し、その後毎時報告します。

  • 2-24 - コレクタが初期化されてから45分後にパッケージを報告し、その後2から24時間ごとに報告します。

1

[0 - 24]

Oui

WME

(クラシック) 設定されると、コレクタはWebとクラウドのデータを報告します。

1

[0 - 1]

Oui

wm_domains

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

-

Non

prefer_ipv6

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

0

[0 - 1]

Non

custom_shells

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

0

[0 - 1]

Non

execution_policy

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

signed_trusted_or_nexthink

  • 無効

  • signed_trusted

  • signed_trusted_or_nexthink

  • 制限なし

Non

customer_key

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

-

暗号キーの含まれるテキストファイルへのパス。

Oui

assignment_status

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

無効

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

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

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

なし(読み取り専用)

use_assignment

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

無効

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

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

はい(有効時のみ)

engage

従業員とエンゲージメントする機能の有効化。

enable_except_on_server_os

  • server_os以外の端末上のエンドユーザーとエンゲージメントする機能の有効化 (server_osを除く)。

  • 無効にしてエンドユーザーとのエンゲージメント機能を解除する。

  • 有効にしてエンドユーザーとのエンゲージメント機能を有効にする。

Oui

data_over_tcp

CollectorデータをTCPで送信する。

有効

  • 無効 Nexthinkクラウドインスタンスには使用できません。

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

Oui

proxy_pac_address

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

-

  • PACファイルのURL

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

Oui

proxy_address

プロキシ設定の手動構成のためのプロキシのFQDN。

-

  • プロキシのアドレス。

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

Oui

プロキシポート

プロキシが手動設定のために待ち受けるポート番号。

-

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

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

Oui

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

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

  • ip

  • tcp_port

  • customer_key

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

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

  • コレクターを停止するには:

Stop-Service -Name "Nexthink Service" -Force
Stop-Service -Name "nxtrdrvwfp" -Force
Stop-Service -Name "nxtrdrv" -Force
  • コレクターを開始するには:

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

顧客キーの設定

コレクターは顧客キーを使用してNexthinkインスタンスのIDを検証し、TLS経由で安全な通信を行います。 このセキュリティパラメーターが変更されると、コレクターインスタンスの構成を調整する必要があります。

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

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

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

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


関連タスク

Last updated

Was this helpful?