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

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

前提条件

完成所有必备条件。有关详细信息，请参见必备条件。
解压缩软件包必须在目标计算机上可用。
用户必须具有下载文件夹的访问权限。
Windows PowerShell 必须 >= 5.0。
客户机 IP 必须已正确配置且在 vCenter Server 之间唯一。如果监控多个具有相同 IP 的受 vCenter Server 云帐户管理的虚拟机，则脚本将无法解析和订阅应用程序监控。
注：此必备条件仅适用于受 vCenter Server 云帐户管理的虚拟机。有关对象类型的更多信息，请参见操作系统和应用程序监控。
受 vCenter Server 云帐户管理的虚拟机必须在 VMware Aria Operations 中可用。
注：此必备条件仅适用于受 vCenter Server 云帐户管理的虚拟机。
必须已为虚拟机所属的 vCenter Server 配置云帐户。
注：此必备条件仅适用于受 vCenter Server 云帐户管理的虚拟机。
目标计算机必须能够访问 VMware Aria Operations 中的端口 443。
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。

要执行脚本并安装/卸载代理，请运行以下命令：

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.
            
            on-prem: Auth Token of the user/account. For getting new token
                     ( https://<VMwareAriaOperations_IP>/suite-api/ or curl -ks -X POST https://<VMwareAriaOperations_IP>/suite-api/api/auth/token/acquire -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d \"{\"username\":\"<VMwareAriaOperations_USER>\",\"password\":\"<VMwareAriaOperations_USER_PASSWORD>\"}\")
      -d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
      -v : [CONDITIONAL] [ON-PREM-SPECIFIC] vmwareariaoperations_ip_or_fqdn - IP/FQDN of VMware Aria Operations master node and required for on-prem.
      
      -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-277c-4383-b910-bd2e89c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101

注：要运行帮助程序脚本，必须使用 -c 参数。

注：请勿在配置路径中使用空格。带空格的路径可以作为短名称标记传递，例如使用 c:\PROGRA~1 表示 c:\Program Files。

要验证引导状态，请查看 uaf-bootstrap-results 文件。如果安装失败，请在 uaf_bootstrap.log 中查找错误消息。

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

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