コマンドラインの基本

次の形式で指定されたURLのManagerに対して、Agentを有効化します。

dsm://<host>:<port>/

指定する項目は次のとおりです。

• <host> には、マネージャの完全修飾ドメイン名（FQDN), IPv4アドレスまたはIPv6アドレス）を指定します。
• <port> マネージャの待機中の ポート番号です。

必要に応じて、有効化中に送信する設定 (説明など) を、この引数に続けて指定することもできます。詳しくは、Agentからのハートビート有効化コマンド (「dsa_control -m」)を参照してください。パラメータはキー:値のペアとして入力する必要があります (セパレータにはコロンを使用します)。入力可能なキー:値のペアの数に制限はありませんが、キー:値のそれぞれのペアをスペースで区切る必要があります。キー:値のペアにスペースや特殊文字が含まれている場合は、キー:値のペアを引用符で囲む必要があります。

AgentのURLです。初期設定:

https://localhost:<port>/

どこに<port>マネージャーが聞いているポート番号。

以前に Workload Security で設定した認証パスワード。詳細については、 Self-protectionの設定（ Workload Security ）を参照してください。設定されている場合、パスワードはすべてのdsa_controlコマンドに含める必要があります。除外dsa_control -a 、dsa_control -x 、およびdsa_control -y 。

例： dsa_control -m -p MyPa$$w0rd

パスワードは、コマンドラインに直接入力した場合、画面上に表示されます。入力時にアスタリスク (*) でパスワードを非表示にするには、対話形式のコマンド -p *を入力します。パスワードの入力が求められます。

例:

dsa_control -m -p *

Agentセルフプロテクションを有効にします (1: 有効、0: 無効)。セルフプロテクションにより、ローカルのエンドユーザはAgentに対してアンインストールや停止などの制御ができなくなります。 詳細については、「Agentセルフプロテクションの有効化または無効化」を参照してください。この機能はWindows版でのみ使用できます。

セルフプロテクションはdsa_controlコマンドで有効化できますが、関連付けられた認証パスワードの設定にはそれには Workload Security が必要です。詳細については、 Self-protectionの設定（ Workload Security ）を参照してください。パスワードが設定されると、 -p または --passwd= オプションを使用してコマンドラインでパスワードを入力する必要があります。

プロキシが認証を要求する場合は、 -x オプションと組み合わせてプロキシのユーザ名とパスワードを指定します。ユーザ名とパスワードは、コロン (:)で区切ります。例： # ./dsa_control -x dsm_proxy://<str> -u <new username>:<new password>。

ユーザ名とパスワードを削除するには、空の文字列（ ""）を入力します。例： # ./dsa_control -x dsm_proxy://<str> -u <existing username>:""。

プロキシのユーザ名のみを変更せずにプロキシのパスワードのみをアップデートする場合は、 -xなしで -u オプションを使用できます。例： # ./dsa_control -u <existing username>:<new password>。

基本認証のみ。Digest認証とNTLM認証はサポートされていません。

注意： 使用 dsa_control -u は、エージェントのローカル設定にのみ適用されます。このコマンドを実行した結果、マネージャ上でセキュリティポリシーが変更されません。

プロキシが認証を要求する場合は、 -y オプションと組み合わせて使用して、プロキシのユーザameおよびパスワードを指定します。ユーザ名とパスワードは、コロン (:)で区切ります。例： # ./dsa_control -y dsm_proxy://<str> -w <new username>:<new password>。

ユーザ名とパスワードを削除するには、空の文字列（ ""）を入力します。例： # ./dsa_control -y dsm_proxy://<str> -w <existing username>:""。

プロキシのユーザ名のみを変更せずにプロキシのパスワードのみをアップデートする場合は、 -yなしで -w オプションを使用できます。例： # ./dsa_control -w <existing username>:<new password>。

-uオプションも参照してください。

詳細については、 Connect to Workload Security （プロキシ経由）を参照してください。

注意：  使用dsa_control -x は、エージェントのローカル設定にのみ適用されます。このコマンドを実行した結果、マネージャ上でセキュリティポリシーが変更されません。

-wオプションも参照してください。

詳細については、 プロキシ経由のリレーへの接続を参照してください。

注意：  使用dsa_control -y は、エージェントのローカル設定にのみ適用されます。このコマンドを実行した結果、マネージャ上でセキュリティポリシーが変更されません。

ブール。

オンデマンド（「手動」） をキャンセルします。現在コンピュータで実行中です。

ブール。

 コンピュータでのオンデマンド（「手動」）不正プログラム検索を開始します。

文字列。

コンピュータの説明を設定します。最大2000文字。

文字列。

[コンピュータ] のホスト名の横にカッコで囲んで表示される表示名を設定します。最大2000文字。

整数。

externalid 値を設定します。この値を使用して、Agentを一意に識別できます。この値には、従来のSOAP WebサービスAPIを使用してアクセスできます。

文字列。

[コンピュータ] 画面に表示される、コンピュータの属するグループを設定します。1つの階層レベルの1つのグループ名につき最大254文字。

スラッシュ（「/」）はグループ階層を示します。 group パラメータは、グループの階層を読み取りまたは作成できます。
このパラメータは、メインの[コンピュータ]ルートブランチ下の標準グループにコンピュータを追加する場合にのみ使用できます。ディレクトリ (Microsoft Active Directory)、VMware vCenter、またはクラウドプロバイダのアカウントに所属するグループにコンピュータを追加する場合には使用できません。

整数。

文字列。

最大254文字。

ホスト名には、マネージャがエージェントへの接続に使用できるIPアドレス、ホスト名、またはFQDNを指定できます。

ブール。

コンピュータで変更の検索を開始します。

文字列。

最大254文字。

ポリシー名は大文字と小文字が区別され、ポリシーリストに一致します。ポリシーが見つからない場合、ポリシーは割り当てられません。

イベントベースのタスクによって割り当てられたポリシーは、エージェント起動アクティベーション時に割り当てられたポリシーよりも優先されます。

整数。

文字列。

コンピュータを特定のRelayグループにリンクします。最大254文字。

リレーグループ名は、既存のリレーグループ名と大文字と小文字が区別されます。Relayグループが見つからない場合は、初期設定のRelayグループが使用されます。

イベントベースのタスクで割り当てられるリレーグループには影響しません。このオプションまたはイベントベースタスクのどちらかを使用してください。

整数。

整数。

文字列。

エージェント起動アクティベーションをテナントとして使用する場合は、 tenantID と token の両方が必要です。 tenantID および token は、配置スクリプト生成ツールから取得できます。

ブール。

コンピュータで推奨設定の検索を開始します。

ブール。

セキュリティ更新を実行するように Workload Security に指示します。

Deep Security Agent 12.0以降で UpdateComponent パラメータを使用する場合は、リレーもバージョン12.0以降であることを確認してください。詳細を表示。

ブール。

コンピュータの 変更監視 ベースラインを再構築します。

ブール。

Workload Security に対して「ポリシーの送信」操作を実行するように指示します。

オプションのAgentセルフプロテクション機能で使用される認証パスワードです。セルフプロテクションを有効化した際にパスワードを指定した場合は必須となります。

Agentに対してクエリコマンドを実行します。次のコマンドがサポートされます。

• "GetHostInfo"：ハートビート中にどのIDがマネージャに返されるかをクエリします。
• "GetAgentStatus"：どの保護モジュールが有効になっているか、 不正プログラム対策 または 変更監視 検索のステータス、およびその他のその他の情報を照会します。
• "GetComponentInfo"：不正プログラム対策パターンファイルとエンジンのバージョン情報をクエリします。
• "GetPluginVersion"：エージェントおよび保護モジュールのバージョン情報をクエリします。

結果をフィルタするためのワイルドカードのパターンです(オプション)。

例:
dsa_query -c "GetComponentInfo" -r "au" "AM*"