コンピュータのリストを取得する (BashおよびPowerShell)

Server & Workload Protectionが保護する (または検出した) コンピュータのリストを取得し、返されたデータに焦点を当てて、各コンピュータのセキュリティステータスを含めます。を使用します。コンピュータの一覧表示コンピュータのリストを取得する操作。オプションのexpandクエリパラメータを使用して、ステータス情報に注目します。

コンピュータを一覧表示すると、初期設定では、使用可能なすべてのコンピュータ情報が返されます。次を使用できます。expandクエリパラメータを使用して、必要な情報のみが返されるようにします。少なくとも、コンピュータID、ポリシーID、プラットフォームなど、各コンピュータに関する基本情報が返されます。

注意

を含めない場合expandクエリ文字列の場合、すべてのコンピュータ情報が返されます。

返される情報のカテゴリ	でサポートされる値 expand
最低限の情報	none
すべての情報	all (初期設定)
現在のステータス	computerStatus , securityUpdates , tasks
設定	computerSettings , interfaces
セキュリティモジュールの設定	allSecurityModules (includes information for all modules), antiMalware , applicationControl , firewall , integrityMonitoring , intrusionPrevention , logInspection , SAP , webReputation
仮想マシン情報	allVirtualMachineSummaries (すべての種類の仮想マシンの情報が含まれます)、 azureARMVirtualMachineSummary , azureVMVirtualMachineSummary , ec2VirtualMachineSummary , ESXSummary , noConnectorVirtualMachineSummary , vcloudVMVirtualMachineSummary , vmwareVMVirtualMachineSummary , workspaceVirtualMachineSummary ,

開始前の準備

環境がBashまたはPowerShellを使用してAPIを使用するように設定する。

このレシピを完了するために必要な次の情報を収集します。

Server & Workload ProtectionのURL
APIキーの秘密鍵

バッシュ

ターミナルまたは任意のコマンドラインツールを開きます。
次のコマンドを入力して、リクエストに関する詳細を保存します。<YOUR URL>のURLでServer & Workload Protection、と<YOUR SECRET KEY> API キーのシークレットを使用して:
- url=<YOUR URL>
  
  たとえば、url=https://cloudone.trendmicro.com
- secret=<YOUR SECRET KEY>
  
  たとえば、secret=5C58EADA-04BC-4ABC-45CF-B72925A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8=
- expand=computerStatus
次のコマンドを入力して、対応データを保存する JSON ファイルを指定します。<FILE PATH>作成するファイルと一緒に。 .json 拡張子が付いたファイル名を指定します。

file=<FILE PATH>

たとえば、file=~/Documents/computers_status.jsonファイルがホームディレクトリの下に保存されます。

次のコマンドを入力して要求を送信します。

curl -X GET "$url/api/computers?expand=$expand" -H "api-secret-key: $secret" -H "api-version:
                           v1" > $file

ヒント

返された JSON をターミナルで (ファイルに書き込むのではなく) 読み取り可能な形式で出力するには、cURL コマンドの結果をパイプして次のようにします。 jq 。上記のコマンドで、次のように置き換えます。> $fileと| jq . 。

WebブラウザでJSONファイルを開きます。 (WebブラウザでJSONを読み取り可能な形式にする必要があります)。コンピュータの配列を表すJSONコードが表示されます。各コンピュータは、次の例のようなコードで表されます。
```
{ "hostName": "gui2-336", "displayName": "", "description": "", "lastIPUsed": "127.0.1.1", "platform": "Unknown", "groupID": 0, "policyID": 1, "relayListID": 0, "lastSendPolicyRequest": 1566335191390, "agentVersion": "0.0.0.0", "computerStatus": { "agentStatus": "inactive", "agentStatusMessages": [ "Unmanaged (Unknown)" ] }, "ID": 201 }
```
はcomputerStatusキーにはステータス情報が含まれます。この例では、コンピュータは保護されていません。
(オプション)expand変数を使用して、返されるJSONにどのように影響するかを確認します。たとえば、次のように入力します。expand=computerPropertiesを再実行します。curlコマンド。

PowerShell

PowerShellを開きます。
Managerがセキュアな接続を確立するために必要なTLS 1.2を使用するには、次のコマンドを入力します。
```
[Net.ServicePointManager]::SecurityProtocol += [Net.SecurityProtocolType]::Tls12
```
次のコマンドを入力して、リクエストに関する詳細を保存します。<YOUR URL>のURLでServer & Workload Protection、と<YOUR SECRET KEY> API キーのシークレットを使用して:
- $url = "<YOUR URL>"
  
  たとえば、url=https://cloudone.trendmicro.com
- $secret = "<YOUR API KEY SECRET>"
  
  たとえば、$secret="5C58EADA-04BC-4ABC-45CF-B72725A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8="
- $headers = @{api-version = v1; api-secret-key = $secret}
- $expand="computerStatus"
次のコマンドを入力して、対応データを保存する JSON ファイルを指定します。<FILE PATH>作成するファイルと一緒に。 .json 拡張子が付いたファイル名を指定します。

$file="<FILE PATH>"

たとえば、$file="$HOME\Documents\computers_status.json"ファイルがホームディレクトリの下に保存されます。