コマンドラインの基本

ローカルのコマンドラインインタフェース (CLI) を使用して、AgentとWorkload Securityに処理の実行を指示できます。また、CLIを使用して一部の設定を行ったり、システムリソースの使用状況を表示したりすることもできます。

多くのCLIコマンドは、 Workload Security APIを使用して自動化できます。詳細については、「 Workload Security Automationに向けたファーストステップ」を参照してください。

dsa_control

dsa_control コマンドを使用して、一部のAgent設定を構成したり、アクティベーション、不正プログラム検索、ベースラインの再構築などの特定の処理を手動で開始したりできます。

次の点に注意してください。

• Windowsでセルフプロテクションが有効になっている場合、ローカルユーザはAgentの管理、たとえばアンインストール、アップデート、停止などを行うことができません。また、CLIコマンドの実行時には、認証パスワードが必要となります。

• macOSでセルフプロテクションが有効になっている場合、ローカルユーザはエージェントをアンインストール、変更、停止、または制御できません。また、CLIコマンドの実行時には、認証パスワードが必要となります。

• dsa_control は英語の文字列のみをサポートします。 Unicodeはサポートされていません。

dsa_controlを使用するには

Windowsの場合:

• 管理者としてコマンドプロンプトを開きます。
• Agentのインストールディレクトリに移動します。
  cd C:\Program Files\Trend Micro\Deep Security Agent\
• dsa_control コマンドを実行します:
  dsa_control <option>
<option> は、dsa_control optionsで説明されているオプションに置き換えられます。

Linuxの場合:

• 次のコマンドを実行します。

sudo /opt/ds_agent/dsa_control <option>
<option> は、dsa_control optionsで説明されているオプションに置き換えられます。

macOSの場合:

• 管理者としてターミナルウィンドウを開きます。
• Agentのインストールディレクトリに移動します。
  cd "/Library/Application Support/com.trendmicro.DSAgent"
• dsa_control コマンドを実行します:
  dsa_control <option>
<option> は、dsa_control optionsで説明されているオプションに置き換えられます。

dsa_control options

dsa_control [-a <str>] [-b] [-c <str>] [-d] [-g <str>] [-s <num>] [-m] [-p <str>] [-r] [-R <str>] [-t <num>] [-u <str>:<str>] [-w <str>:<str>] [-x dsm_proxy://<str>] [-y relay_proxy://<str>] [--buildBaseline] [--scanForChanges] [Additional keyword:value data to send to Workload Security during activation or heartbeat...]

Agentからのアクティベーション (dsa_control -a)

エージェント起動アクティベーション（AIA）を有効にすると、マネージャとエージェント間の通信に問題が発生するのを防ぐことができ、配信スクリプトを使用してエージェントを簡単に配信できます。

AIAを設定し、インストールスクリプトを使用してAgentを有効化する方法については、「Agentからのリモート有効化およびAgentからの通信を使用してAgentを有効化して保護する」を参照してください。

コマンドの形式は dsa_control -a dsm://<host>:<port>/ です。

• <host> マネージャの完全修飾ドメイン名 (FQDN) , IPv4アドレス、またはIPv6アドレスのいずれかになります。
• <port> はAgentからManagerへの通信です ポート番号 443.

たとえば、次のとおりです。

dsa_control -a dsm://dsm.example.com:4120/ hostname:www12 "description:Long Description With Spaces"

dsa_control -a dsm://fe80::ad4a:af37:17cf:8937:4120

Agent起動ハートビートコマンド (dsa_control -m)

AgentからManagerに、ハートビートをただちに強制送信することができます。

アクティベーションと同様に、接続中に設定をManagerに送信することもできます。

Agentを有効化する

コマンドラインからAgentを有効にするには、テナントIDとパスワードを知っている必要があります。これらはどちらも配信スクリプトから取得できます。

1. [Workload Security] の右上で、[ Support]→[Deployment Scripts] の順にクリックします。
2. プラットフォームを選択します。
3. [インストール後にAgentを自動的に有効化] を選択します。
4. 展開スクリプトで、 tenantID および tokenの文字列を指定します。

Windows

PowerShellの場合:

& $Env:ProgramFiles"\Trend Micro\Deep Security Agent\dsa_control" -a <manager URL> <tenant ID> <token>

cmd.exeの場合:

C:\Windows\system32>"\Program Files\Trend Micro\Deep Security Agent\dsa_control" -a <manager URL> <tenant ID> <token>

Linux

/opt/ds_agent/dsa_control -a <manager URL> <tenant ID> <token>

macOS

cd "/Library/Application Support/com.trendmicro.DSAgent/"

sudo ./dsa_control -a <manager URL> <tenant ID> <token>

Agentからのハートビート有効化コマンド

Windows

PowerShellの場合:

& "\Program Files\Trend Micro\Deep Security Agent\dsa_control" -m

cmd.exeの場合:

C:\Windows\system32>"\Program Files\Trend Micro\Deep Security Agent\dsa_control" -m

Linux

/opt/ds_agent/dsa_control -m

macOS

cd "/Library/Application Support/com.trendmicro.DSAgent/"

sudo ./dsa_control -m

不正プログラムの手動検索を開始する

Windows

1. 管理者としてコマンドプロンプト (cmd.exe) を開きます。

2. 次のコマンドを入力します。

   cd C:\Program Files\Trend Micro\Deep Security Agent\

   dsa_control -m "AntiMalwareManualScan:true"

Linux

/opt/ds_agent/dsa_control -m "AntiMalwareManualScan:true"

macOS

サポートされていません。

診断パッケージを作成する

Agentの問題のトラブルシューティングが必要な場合、サポートプロバイダから診断パッケージを作成してコンピュータから送信するように求められることがあります。詳細については、「保護対象のコンピュータでCLIを使用してAgent診断パッケージを作成する」を参照してください。

Workload Securityを使用してAgentコンピュータの診断パッケージを生成できますが、 AgentコンピュータがAgent/Applianceからの通信 を使用するように設定されている場合、Managerは必要なすべての診断パッケージを収集できません。ログ。したがって、テクニカルサポートから診断パッケージを要求された場合は、Agentコンピュータで直接コマンドを実行する必要があります。 {: .note }

Agentをリセットする

このコマンドは、対象Agentから有効化情報を削除し、対象Agentを無効化します。

Windows

PowerShellの場合:

& "\Program Files\Trend Micro\Deep Security Agent\dsa_control" -r

cmd.exeの場合:

C:\Windows\system32>"\Program Files\Trend Micro\Deep Security Agent\dsa_control" -r

Linux

/opt/ds_agent/dsa_control -r

macOS

cd "/Library/Application Support/com.trendmicro.DSAgent/"

sudo ./dsa_control -r

dsa_query

エージェント情報を表示するには、 dsa_query コマンドを使用できます。

このコマンドはmacOSではサポートされないことに注意してください。

dsa_queryのオプション

dsa_query [-c <str>] [-p <str>] [-r <str]

CPU使用率とRAM使用量を確認する

Windows

タスクマネージャーまたはprocmonを使用します。

Linux

top

ds_agentプロセスまたはサービスが実行されていることを確認する

Windows

タスクマネージャーまたはprocmonを使用します。

Linux

ps -ef|grep ds_agent

LinuxでAgentを再起動する

service ds_agent restart

または

/etc/init.d/ds_agent restart

or

systemctl restart ds_agent

アクションの中には、-tenantnameパラメータまたはa-tenantidパラメータ。テナント名を使用すると実行エラーが発生する場合は、関連付けられたテナントIDを使用してコマンドを再度実行します。

dsa_scan

Windowsでは管理者権限、Linuxではrootアクセス権を持っている場合は、 dsa_scan コマンドを使用して、指定したファイルまたはディレクトリ (サブディレクトリを含む) で検索タスクを実行できます。

dsa_scan では、最大10個のDeep Security Agentインスタンスを同時に実行できます。

このコマンドは、対象および除外の設定に関するAgentの現在の検索ポリシーを無視します ( [ポリシー]→[不正プログラム対策]→[対象]→[手動検索]および[ポリシー]→[不正プログラム対策]→[検索除外]→[手動検索] )。

dsa_scanを使用するには

Windowsの場合:

• 管理者としてコマンドプロンプトを開きます。
• Agentのインストールディレクトリに移動します。
  cd C:\Program Files\Trend Micro\Deep Security Agent\
• dsa_scan コマンドを実行します:
  dsa_scan <option>
<option> は、dsa_scan optionsで説明されている1つ以上のオプションです。

Linuxの場合:

• 次のコマンドを実行します。

sudo /opt/ds_agent/dsa_scan <option>
<option> は、dsa_scan optionsで説明されている1つ以上のオプションです。

dsa_scan コマンドはmacOSではサポートされていません。

dsa_scanのオプション

dsa_scan [--target <str>] [--action <str>] [--log <str>]

dsa_scanの出力{#Scanoutput}

次の表は、 dsa_scan コマンドの実行後に表示される検索ステータスラベルを示しています。

次に、検索出力の例を示します。

C1WS DSA on-demand scan utility

System date/time: 2023/10/12 16:04:10
trace id: 7acf6855-8547-46fc-a58f-9218d108e727
Scanning...

[Skipped] Path: /home/user1/Documents/oversize.zip
[Skipped] Path: /home/user1/Documents/xxx.big
[Infected] Path: /home/user1/Documents/readme, Action: Passed, Malware Name: EICAR, QuarantineID: 0, Error code: 0
[Infected] Path: /home/user1/Documents/sales.doc, Action: Cleaned, Malware Name: BRAIN.A, QuarantineID: 0, Error code: 0
[Warning] Path: /home/user1/Documents/po.ppt, Action: Quarantine, Malware Name: RANSOM.A, QuarantineID: 0, Error code: 5
[Infected] Path: /home/user1/Documents/shipment.zip(po.exe), Action: Deleted, Spyware Name: BLKFRI.A, QuarantineID: 0, Error code: 0

25 files scanned, 2 skipped in 10 seconds.
4 files out of 25 were infected.

End of Scan.

検索終了コード{#Exitcodes}

dsa_scan コマンドの終了コードは、検索の成功または失敗を示します。

成功の終了コード

正常終了コードは、 dsa_scan ユーティリティが問題を検出せずに、またはウイルスが検出されるか、一部のファイルをスキップすることなく検索タスクを完了した場合に表示されます。

致命的な終了コード

dsa_scan ユーティリティで致命的なエラーが発生した場合、 dsa_scan は検索タスクを中断し、次の表に示すエラーコードを表示して終了します。