Windows プラットフォームにおけるスクリプトでのエージェントのインストール/アンインストール

スクリプトを使用して、ターゲットマシンにエージェントをインストールまたはアンインストールできます。

前提条件

すべての前提条件を満たします。詳細については、「前提条件」を参照してください。
解凍パッケージは、ターゲットマシンで使用できる必要があります。
ユーザーにダウンロードフォルダへのアクセス権限が必要です。
クラウドアカウントは、仮想マシンが属する vCenter Server 用に構成されている必要があります。vCenter Server にマッピングされているアプリケーション監視アダプタは、存在しない場合に作成されます。
注：この前提条件は、 vCenter Server クラウドアカウントによって管理されている仮想マシンにのみ適用されます。オブジェクトタイプの詳細については、 OSとアプリケーションの監視を参照してください。
vCenter Server クラウドアカウントによって管理されている仮想マシンは、VMware Aria Operations で使用できる必要があります。
注：この前提条件は、 vCenter Server クラウドアカウントによって管理されている仮想マシンにのみ適用されます。
ゲスト IP アドレスが適切に構成され、vCenter Server 全体で一意である必要があります。同じ IP アドレスを持つ複数の仮想マシンが vCenter Server クラウドアカウントによって管理されている場合、スクリプトは解決されず、アプリケーションの監視にサブスクライブすることはできません。
注：この前提条件は、 vCenter Server クラウドアカウントによって管理されている仮想マシンにのみ適用されます。オブジェクトタイプの詳細については、 OSとアプリケーションの監視を参照してください。
インターネットが有効であることを確認します。
VMware Aria Operations ユーザーに、次の権限が必要です。
- 管理 > REST-API > その他のすべての読み取り、書き込み API
- 管理 > REST-API > API への読み取りアクセス
- 環境 > アプリケーション > Telegraf エージェントの管理
- 環境 > アクション > 仮想マシンのブートストラップ
- 環境 > アクション > ブートストラップのダウンロード
注：権限を確認し、 [管理] > [アクセスコントロール] > [ロール] の順に移動して、ユーザーが割り当てられているロールを選択します。権限はページの右端に表示されます。
現在、クラウドプロキシでは IPv4 のみがサポートされています。
VMware Tools のバージョンは 10.2 以上にする必要があります。
注： vCenter Server クラウドアカウントによって管理される仮想マシンにのみ適用されます。

手順

エージェントをインストールまたはアンインストールするターゲットマシンにログインし、次の場所でクラウドプロキシからサンプルスクリプトをダウンロードします。https://<CloudProxy>/downloads/salt/telegraf-utils.ps1
スクリプトのダウンロードが失敗し、 要求が中止されました：SSL/TLS セキュアチャネルを作成できませんでした というメッセージが表示される場合は、 Windows プラットフォームでスクリプトのダウンロードに失敗するに記載されている手順に従ってください。
次のいずれかのコマンドを実行します。
```
PowerShell command:
Invoke-WebRequest "https://<CloudProxy>/downloads/salt/telegraf-utils.ps1" -OutFile telegraf-utils.ps1

Or if you have the wget tool:
wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.ps1
```
注：上記で指定したコマンドおよび場所の <CloudProxy> には、関連するクラウドプロキシ [IP アドレス] を使用します。アプリケーション監視の高可用性が有効なコレクタグループの場合は、仮想 IP アドレスを指定します。
現在の組織に関連付けられているユーザーの更新トークンを、クラウドサービスポータルの次の場所から作成します: [ユーザー/組織設定] > [マイアカウント] > [API トークン] > [新しい API トークンを生成]

スクリプトを実行し、エージェントをインストールまたはアンインストールするには、次のコマンドを実行します。

telegraf-utils.ps1  product-managed -c cloud_proxy_ip_or_collector_group_name -t token (-v vmwareariaoperations_ip_or_fqdn | [-g gateway_url -a csp_auth_url]) [-d download_tmp_dir -s sleep_seconds -i list_of_IPs -o operation]
    
Description of arguments:
      -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
      -t : [REQUIRED] token - This can be user_saas_refresh_token or on-prem vmwareariaoperations_auth_token.
            saas: CSP Refresh Token of the user/account. For getting new token, follow - User/
                  Organization Settings >> My Account >> API Tokens >> Generate a New API Token.
                  Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
            
      -d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
      
      -g : [OPTIONAL] [SAAS-SPECIFIC] gateway_url - argument to override default VMware Aria Operations SaaS gateway URL
      -a : [OPTIONAL] [SAAS-SPECIFIC] csp_auth_url - argument to override default CSP authentication URL
      -o : [OPTIONAL] operation - The type of operation to be performed {install,uninstall} Default: install
      -s : [OPTIONAL] sleep_seconds - Time (in seconds) to delay the script execution. This optional parameter will be helpful when this script is used in vRA to have agent installed on deploying VM. Recommended time 600 seconds.
      -i : [OPTIONAL] list_of_IPs - This is an optional parameter. Comma separated IPs that are set as properties of a VM in VMware Aria Operations (VM -> Properties -> Network -> <Integer> -> IP Address). If single adapter has multiple IP Addresses, then delimit them using '_'
                    ex:- If your VM has 3 adapters with IP Address as follows: Adapter1: 10.0.0.1 Adapter2: 10.0.0.2 & 10.0.0.3 Adapter3: 10.0.0.4
                    Then this parameter should be given as "10.0.0.1,10.0.0.2_10.0.0.3,10.0.0.4"

Example: .\telegraf-utils.ps1 product-managed -t 8dab02cc-265c-4392-b910-bd2e89c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101

注：ヘルパースクリプトを実行するには、 -c 引数が必須です。

注：デフォルトゲートウェイ URL は https://www.mgmt.cloud.vmware.com/vrops-cloud で、デフォルト認証 URL は https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize です。認証 URL とゲートウェイ URL がデフォルトの設定と異なる場合は、適切な引数（-g および -a）を指定します。

ブートストラップのステータスを確認するには、 uaf-bootstrap-results のファイルを確認します。インストールが失敗した場合は、 uaf_bootstrap.log でエラーメッセージを探します。

スクリプトが正常に実行された場合は、1 回の収集サイクル後に [Telegraf エージェントの管理] タブのエージェントステータスが更新されます。サイクルの完了には約 5 ～ 10 分かかります。

注：自動化スクリプトを使用する場合、バッチサイズが 20 のエージェントの同時インストールがサポートされます。