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

Windows用Collector設定ツール

概要

Nxtcfgは、Collectorの構成パラメータを読み取りおよび修正する小さなコンソールアプリケーションです。 管理者権限でNxtcfgを実行します。

インストール

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

C:\Windows\System32\nxtcfg.exe

必要がなければ、Collectorをインストールする際にMSIコマンドラインにオプションCFG_INSTALL=0を追加してください。

オプション

オプション
[説明]
例

/スタート

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

nxtcfg.exe /start

/ストップ

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

nxtcfg.exe /stop

/リスタート

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

nxtcfg.exe /restart

/g

特定の構成パラメーターの値をコレクターから取得します。 次のセクションに記載されているパラメーターの一覧を参照してください。

nxtcfg.exe /g ip

/s

コレクターの一部またはすべての構成パラメーターの値を設定します。 次のセクションに記載されているパラメーターの一覧を参照してください。

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

+ 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 [truncated] docs-----END CUSTOMER KEY-----
root_ca=-----BEGIN CERTIFICATE-----docs [truncated] 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=有効

nxtcfg.exeが正常に完了しました。

構成パラメータ

一部のパラメーターを変更するには、すべての変更が有効になるようにコレクターを再起動する必要があります。 デバイスを再起動することで、すべてのコレクターコンポーネントが強制的に再起動されます。 各パラメーターは、パラメーターテーブルの**「再起動が必要」**列で指定された値によって示されます：

  • いいえ 再起動またはコンポーネントの再起動は不要です。

  • はい コレクターの再起動またはデバイスの再起動が必要です。

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

ip

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

-

-

いいえ

tcp_port

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

-

[1024 - 65535]

はい

タグ

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

0

[0 - 2147483647]

いいえ

string_tag

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

-

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

いいえ

cgpi

クラッシュガードの保護間隔値は、システムの再起動後にクラッシュガードが増加することがない時間間隔です（分）。

240 分

-

はい

logmode

ログモード：

  • 0 - サイレント

  • 1 - 詳細モード

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

0

[0 - 2]

いいえ

logsize

ログファイルの最大サイズが記録される際に、ログが有効になっています。 最大サイズに達した場合、ログが回転されます。

32 MB

[1 - 512] MB

はい

iops

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

0

[0 - 1]

はい

dwef

設定時、コレクターはアプリケーションがフリーズまたは応答しなくなった場合に報告しません。

0

[0 - 1]

はい

pkg_interval

Collector は一定の時間 (時間単位) で新しいインストールされたパッケージや更新をチェックし、それらを報告します：

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

  • 1 - コレクタが初期化した後、毎時間パッケージを報告する。

  • 2-24 - Collector が初期化した後、45 分後にレポートを作成し、その後 2 時間から 24 時間ごとに報告します。

1

[0 - 24]

はい

wme

（クラシック）設定時、コレクターはウェブとクラウドデータを報告します。

1

[0 - 1]

はい

wm_domains

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

-

ドメイン名をカンマ区切りで指定

いいえ

prefer_ipv6

設定時、コレクターはIPv6を優先してNexthinkインスタンスとの通信を行います。

0

[0 - 1]

いいえ

custom_shells

設定時、コレクターはExplorerがデフォルトシェルでない環境でユーザーのログオンイベントを報告します。 例として、特定の埋め込み（キオスクモード）または仮想化環境で使用されます。

0

[0 - 1]

いいえ

execution_policy

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

signed_trusted_or_nexthink

  • 無効

  • signed_trusted

  • signed_trusted_or_nexthink

  • 無制限

いいえ

customer_key

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

-

暗号化キーを保存したテキストファイルへのパス。

はい

assignment_status

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

無効

  • 無効 コレクターは割り当てを使っていません。

  • 待機中 コレクターはエンジンに割り当てを待っています。

  • 割り当て済み コレクターはエンジンに割り当てられています。

いいえ（読み取り専用）

use_assignment

（クラシック）コレクターに割り当てサービスを利用するかどうか指示します。

無効

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

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

はい（有効化時のみ）

engage

従業員とエンゲージする機能をアクティベートします。

サーバーOS以外で有効

  • 最終ユーザーとエンゲージするための機能をアクティベートします。ただし、サーバータイプのOSが稼働するデバイスでは除外されます。

  • 無効 エンゲージ機能を無効にします。

  • 有効 最終ユーザとエンゲージするための機能をアクティベートします。

はい

data_over_tcp

コレクターのデータを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を停止するには：

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インスタンスの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?