# Windows用のCollector設定ツール

## 概要 <a href="#collectorconfigurationtoolforwindows-overview" id="collectorconfigurationtoolforwindows-overview"></a>

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

## インストール <a href="#collectorconfigurationtoolforwindows-installation" id="collectorconfigurationtoolforwindows-installation"></a>

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

`C:\Windows\System32\nxtcfg.exe`

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

## オプション <a href="#collectorconfigurationtoolforwindows-options" id="collectorconfigurationtoolforwindows-options"></a>

<table data-full-width="false"><thead><tr><th>オプション</th><th>説明</th><th>例</th></tr></thead><tbody><tr><td>/start</td><td>コレクターを開始します。</td><td><code>nxtcfg.exe /start</code></td></tr><tr><td>/stop</td><td>コレクターを停止します。</td><td><code>nxtcfg.exe /stop</code></td></tr><tr><td>/restart</td><td>コレクターを再起動します。</td><td><code>nxtcfg.exe /restart</code></td></tr><tr><td>/g</td><td>コレクターから特定の設定パラメーターの値を取得します。 次のセクションの表で、可能なパラメーターの一覧を確認してください。</td><td><code>nxtcfg.exe /g ip</code></td></tr><tr><td>/s</td><td>コレクターの1つまたは複数の設定パラメーターの値を設定します。 次のセクションの表で、可能なパラメーターの一覧を確認してください。</td><td><code>nxtcfg.exe /s ip=nxdocs.data.eu.nexthink.cloud tcp_port=443</code></td></tr><tr><td>/l</td><td>現在の値とともに、コレクターのすべての設定パラメーターを一覧表示します。</td><td><code>nxtcfg.exe /l</code></td></tr></tbody></table>

<details>

<summary>オプション/lの例の出力 – ローカルの管理者がインストールされたバージョン番号を再確認するために使用します。</summary>

```
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.
```

</details>

## 設定パラメータ <a href="#collectorconfigurationtoolforwindows-configurationparameters" id="collectorconfigurationtoolforwindows-configurationparameters"></a>

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

* **いいえ**\n再起動またはコンポーネントの再起動は必要ありません。
* **はい**\nCollectorの再起動またはデバイスの再起動が必要です。

<table data-full-width="false"><thead><tr><th>パラメータ</th><th>説明</th><th>デフォルト値</th><th>範囲</th><th>再起動が必要</th></tr></thead><tbody><tr><td>ip</td><td>Nexthink インスタンスの完全修飾ドメイン名（FQDN）。</td><td>-</td><td>-</td><td>いいえ</td></tr><tr><td>tcp_port</td><td>Nexthink インスタンスとのTCP通信のためのポート番号。</td><td>-</td><td>[1024 - 65535]</td><td>あり</td></tr><tr><td>tag</td><td>インストールを識別するためのオプションの整数番号。</td><td>0</td><td>[0 - 2147483647]</td><td>いいえ</td></tr><tr><td>string_tag</td><td>インストールを識別するためのオプションのラベル。</td><td>-</td><td>任意の文字列（最大2048文字）</td><td>いいえ</td></tr><tr><td>cgpi</td><td>クラッシュガード保護間隔値は、システム起動からの時間（分）であり、汚い再起動なとがクラッシュガードを増加させない時間間隔です。</td><td>240分</td><td>-</td><td>あり</td></tr><tr><td>logmode</td><td><p>ログモード：</p><ul><li>0-サイレント</li><li>1-詳細</li><li>2-デバッグ（本番環境では推奨されません）</li></ul></td><td>0</td><td>[0 - 2]</td><td>いいえ</td></tr><tr><td>logsize</td><td>ログが有効の場合のログファイルの最大サイズ。 最大に達した時、ログは回転されます。</td><td>32MB</td><td>[1 - 512]MB</td><td>あり</td></tr><tr><td>dpsp</td><td>SMB印刷監視サブ機能を無効（1）または有効（0）にします。</td><td>1</td><td>[0 - 1]</td><td>あり</td></tr><tr><td>iops</td><td>IOPS監視機能を有効（1）または無効（0）にします。</td><td>0</td><td>[0 - 1]</td><td>あり</td></tr><tr><td>dwef</td><td>設定すると、Collectorはアプリケーションがフリーズまたは応答を停止した時に報告しません。</td><td>0</td><td>[0 - 1]</td><td>あり</td></tr><tr><td>pkg_interval</td><td><p>Collectorが新しいインストールパッケージと更新の有無をチェックしレポートする間隔（時間単位）：</p><ul><li>0 - パッケージを全く報告しません。</li><li>1 - Collectorが初期化後、毎時間パッケージを報告します。</li><li>2 - 24 - Collectorが初期化後45分で報告し、その後2から24時間ごとに報告します。</li></ul></td><td>1</td><td>[0 - 24]</td><td>あり</td></tr><tr><td>wme</td><td>(クラシック)設定すると、CollectorはWebおよびクラウドデータを報告します。</td><td>1</td><td>[0 - 1]</td><td>あり</td></tr><tr><td>wm_domains</td><td>(クラシック)WebリクエストのURLを報告するドメインのリスト。</td><td>-</td><td>カンマで区切られたドメイン名</td><td>いいえ</td></tr><tr><td>prefer_ipv6</td><td>設定すると、CollectorはFQDNがIPv6およびIPv4アドレス両方で解決された場合、IPv6を優先してNexthinkインスタンスと通信します。</td><td>0</td><td>[0 - 1]</td><td>いいえ</td></tr><tr><td>custom_shells</td><td>設定すると、Explorerがデフォルトシェルでない環境でCollectorがユーザーのログオンイベントを報告できるようにします。 たとえば、特定の組み込み環境（キオスクモード）または仮想化された環境です。</td><td>0</td><td>[0 - 1]</td><td>いいえ</td></tr><tr><td>execution_policy</td><td>リモートアクションのスクリプトを実行する際に適用されるセキュリティポリシー。</td><td>signed_trusted_or_nexthink</td><td><ul><li>無効</li><li>signed_trusted</li><li>signed_trusted_or_nexthink</li><li>制限なし</li></ul></td><td>いいえ</td></tr><tr><td>customer_key</td><td>Nexthink インスタンスのカスタマーキー。</td><td>-</td><td>暗号キーが記載されたテキストファイルへのパス。</td><td>あり</td></tr><tr><td>assignment_status</td><td>（クラシック）Collectorの割り当てのステータス。</td><td>無効</td><td><ul><li>Collectorは割り当てサービスを使用していません。</li><li>Collectorはエンジンへの割り当て待機中です。</li><li>Collectorはエンジンに割り当てられています。</li></ul></td><td>いいえ（読み取り専用）</td></tr><tr><td>use_assignment</td><td>(クラシック）Collectorに割り当てサービスを使用するかどうかを指示します。</td><td>無効</td><td><ul><li>Collectorに割り当てサービスを使用しないよう指示します。</li><li>Collectorに割り当てサービスを使用するよう指示します。</li></ul></td><td>有効（有効化時のみ）</td></tr><tr><td>engage</td><td>従業員との連携機能の有効化。</td><td>サーバーOS以外のデバイスでエンドユーザーと連携する機能を有効化します。</td><td><ul><li>エンドユーザーと連携する機能を無効化します。</li><li>エンドユーザーと連携する機能を有効化します。</li><li>エンドユーザーとの関与を促進するために、機能を有効にしてください。</li></ul></td><td>あり</td></tr><tr><td>data_over_tcp</td><td>CollectorデータをTCP経由で送信します。</td><td>有効</td><td><ul><li>無効<br>Nexthinkクラウドインスタンスではもう不可能です。</li><li>有効<br>エンドユーザーデータをTCPチャネル経由で送信します。</li></ul></td><td>あり</td></tr><tr><td>proxy_pac_address</td><td>プロキシ設定を自動的に構成するための PAC ファイルの URL です。</td><td>-</td><td><ul><li>PAC ファイルの URL</li><li>"" PAC ファイルを使用しない</li></ul></td><td>あり</td></tr><tr><td>proxy_address</td><td>手動でプロキシ設定を構成するためのプロキシの FQDN です。</td><td>-</td><td><ul><li>プロキシのアドレス。</li><li>"" 手動プロキシ設定を使用しない。</li></ul></td><td>あり</td></tr><tr><td>proxy_port</td><td>手動でプロキシ設定を構成するプロキシの待ち受け用ポート番号です。</td><td>-</td><td><ul><li>プロキシのポート番号。</li><li>"" 手動プロキシ設定を使用しない。</li></ul></td><td>あり</td></tr></tbody></table>

## リモートアクションでのNxtcfg <a href="#collectorconfigurationtoolforwindows-nxtcfginremoteactions" id="collectorconfigurationtoolforwindows-nxtcfginremoteactions"></a>

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"
```

## カスタマーキーの設定 <a href="#collectorconfigurationtoolforwindows-settingthecustomerkey" id="collectorconfigurationtoolforwindows-settingthecustomerkey"></a>

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

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

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

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

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

***

関連タスク

* [Collectorのインストール](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/installing-collector-on-windows)
* [Collectorのプロキシサポート](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/windows-collector-references/windows-collector-proxy-support)
* [HTTPウェブリクエストのURL報告](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/windows-collector-references/reporting-the-url-of-http-web-requests-classic)