在 Windows 平台上使用脚本安装/卸载代理

您可以使用脚本在目标计算机上安装或卸载代理。

前提条件

完成所有必备条件。有关详细信息，请参见必备条件。
解压缩软件包必须在目标计算机上可用。
用户必须具有下载文件夹的访问权限。
必须已为虚拟机所属的 vCenter Server 配置云帐户。如果映射到 vCenter Server 的应用程序监控适配器不存在，则会创建该适配器。
注：此必备条件仅适用于受 vCenter Server 云帐户管理的虚拟机。有关对象类型的更多信息，请参见操作系统和应用程序监控。
受 vCenter Server 云帐户管理的虚拟机必须在 VMware Aria Operations 中可用。
注：此必备条件仅适用于受 vCenter Server 云帐户管理的虚拟机。
客户机 IP 必须已正确配置，并且应在 vCenter Server 之间唯一。如果监控多个具有相同 IP 的受 vCenter Server 云帐户管理的虚拟机，则脚本将无法解析和订阅应用程序监控。
注：此必备条件仅适用于受 vCenter Server 云帐户管理的虚拟机。有关对象类型的更多信息，请参见操作系统和应用程序监控。
确保已启用 Internet。
VMware Aria Operations 用户必须具有以下权限：
- 系统管理 > REST-API > 所有其他读取、写入 API
- 系统管理 > REST-API > 对 API 的读取访问权限
- 环境 > 应用程序 > 管理 Telegraf 代理
- 环境 > 操作 > 引导虚拟机
- 环境 > 操作 > 下载引导程序
注：要检查权限，请导航到系统管理 > 访问控制 > 角色，选择分配给用户的角色。可以在页面末尾右侧查看权限。
云代理目前仅支持 IPv4。
VMTools 版本必须 >= 10.2。
注：仅适用于受 vCenter Server 云帐户管理的虚拟机。

过程

登录到要在其上安装/卸载代理的目标计算机，并通过云代理从以下位置下载示例脚本：https://<CloudProxy>/downloads/salt/telegraf-utils.ps1 。
如果脚本下载失败并显示以下消息： 请求已中止: 无法创建 SSL/TLS 安全通道 (The request was aborted: Could not create SSL/TLS secure channel)，请按照在 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 中查找错误消息。

如果脚本成功，则在一个收集周期（需要 5-10 分钟的时间）过后，将在管理 Telegraf 代理选项卡中更新代理状态。

注：使用自动化脚本时，支持批大小为 20 的并发代理安装。