# 脚本管理
#### 操作场景
管理员可在管理控制台上根据创建的脚本对云桌面执行远程命令行操作。
![](https://support.huaweicloud.com/usermanual-workspace/public_sys-resources/note_3.0-zh-cn.png)
Windows云桌面默认设置是禁止远程执行powershell脚本，需要配置允许执行远程powershell脚本功能，操作方法如下：
1. 在脚本管理页面单击"创建脚本"。
2. 自定义输入脚本名，选择执行环境为"Windows Script（Windows 系统）"，输入描述内容。
3. 输入脚本内容：powershell -Command "Set-ExecutionPolicy -ExecutionPolicy RemoteSigned"，单击"确定"。
4. 选择执行脚本，执行新创建的脚本，执行成功后桌面将可以使用powershell脚本功能。
 
#### 前提条件
已获取脚本内容。
#### 操作限制
批量命令API对组件的要求如下：
WKSAppCenterAgent 1.2.16及以上版本。
HW.SysAgent 24.8.30.19029及以上版本。
#### 操作步骤
**创建脚本**
1. [登录管理控制台](https://console.huaweicloud.com/workspace/v2/#/console)。
2. 在左侧导航中依次选择"运维管理 \> 脚本管理"。 
   进入"脚本管理"页面。
   
   
3. 单击右上角"创建脚本"，进入 "创建脚本"页面。
4. 配置脚本信息。 
   - 脚本名：创建脚本的名称，脚本名不能重复，输入不能为空。
   
   - 执行环境：根据需求选择Windows Script（Windows系统）、Windows Powershell（Windows系统）、Linux Shell（Linux系统）。
   
   - 描述内容：根据所需输入描述内容。
   
   - 脚本内容：根据所需输入执行脚本的内容。
   
   
   
   
5. 单击"确定"完成。
**执行脚本**
6. 在脚本列表页面勾选待执行的脚本。
7. 勾选所需执行的脚本，单击"执行脚本"，弹出"执行脚本"页面。 
   - 如需新增执行脚本个数，单击"添加脚本"，在弹出的"添加脚本"页面勾选需要执行的脚本，单击"确定"。
   
   - 如需取消执行脚本个数，在"执行脚本"页面单击"取消选择"。
   
   
   
   
8. 勾选"我已检查，没问题"，单击"下一步"，进入"选择应用对象"页面。
9. 在"可选对象"的搜索框中通过桌面、桌面池、桌面标签搜索桌面并勾选，单击"下一步"。 
   ![](https://support.huaweicloud.com/usermanual-workspace/public_sys-resources/note_3.0-zh-cn.png)
   "应用对象"中的桌面名称支持批量搜索：输入多个筛选条件，多个值之间用英文"逗号"分隔，如：*Desktop1,Desktop2,Desktop3*。
   
   
10. 选择执行策略如[表1]所示。
    
     表1执行策略 
    | 执行策略方式 | 参数说明                                                                                                                                                                 | 操作说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
    |:---|:---|:---|
    | 全量下发     | 默认所勾选桌面/桌面池全部执行脚本。                                                                                                                                                     | 1. 执行策略选择"全量下发"。  2. 根据业务诉求设置脚本超时时间，范围为1\~600分钟。                                                                                                                                                                                                                                                                                                                     |
    | 灰度下发    | 指定：选择执行的桌面/桌面池是否首批执行脚本。                                                                                                                                             | 1. 执行策略选择"灰度下发"，灰度规则选择"指定"。  2. 打开在桌面所在行"是否首批执行"开关，选择指定桌面。 说明： 只有运行状态为运行中，且登录状态为断开连接、使用中、就绪的桌面可以开启首批执行。   3. 根据业务诉求设置脚本超时时间，范围为1\~600分钟。  4. 输入首批执行失败桌面数大于或等于*x*台则停止执行下一批任务的阈值。   |
    | 灰度下发    | 随机：随机选择桌面/桌面池执行脚本。 说明： 灰度下发策略会将桌面分为灰度批次以及非灰度批次，输入首批执行失败桌面数大于或等于*x*台的阈值，如果灰度首批次的桌面执行脚本失败的任务数量大于或等于设置的阈值，非灰度批次的桌面不会执行脚本，反之则是非灰度执行脚本。 | 1. 执行策略选择"灰度下发"，灰度规则选择"随机"。  2. 根据业务诉求设置脚本超时时间，范围为1\~600分钟。  3. 在随机首次执行桌面数*x*台输入阈值。  4. 输入首批执行失败桌面数大于或等于*x*台，则停止执行下一批任务的阈值。                                                                                    |
       
    
    
11. 如果您确定要执行该操作，请输入：YES，单击"一键输入"可以快速输入。单击"确定执行"。 
    ![](https://support.huaweicloud.com/usermanual-workspace/public_sys-resources/note_3.0-zh-cn.png)
    脚本执行结果可以在"脚本管理 \> 桌面脚本记录/桌面池脚本记录"查看。
    
    
**编辑脚本**
12. 在待修改脚本所在行右侧操作列单击"编辑"，弹出"编辑脚本"页面。
13. 根据所需可修改"脚本名"、"描述"、"脚本内容"等信息。
14. 单击"确定"完成。
**复制脚本**
15. 在待复制脚本所在行右侧操作列单击"复制"，弹出"复制脚本"页面。
16. 根据所需可修改复制的"脚本名"、"执行环境"、"描述"、"脚本内容"等信息。
17. 单击"确定"完成。
**删除脚本**
18. 在待删除脚本所在行右侧操作列单击"复制"，弹出"删除脚本"页面。
19. 单击"确定"完成。
**桌面/桌面池脚本记录**
1. 在"桌面脚本记录"页签通过"桌面ID"、"脚本ID"、"任务ID"、"执行情况"、"是否首批执行"、"执行开始时间"可以查看对应桌面的"桌面名称/ID"、"脚本名/ID"、"任务ID"、"执行情况"、"是否首批执行"、"响应内容"、"执行历史"、"执行开始时间"、"执行结束时间"。 
   ![](https://support.huaweicloud.com/usermanual-workspace/public_sys-resources/note_3.0-zh-cn.png)
   - 在"脚本名/ID"所在列单击脚本名可以查看历史脚本详情。
   
   - 在"执行情况"所在列单击"重试"，单击"是"可以重新执行该脚本。
   
   - 在"响应内容"所在列单击"查看"可以查看执行脚本桌面的响应内容，单击"下载"可以下载脚本桌面的响应内容。
   
   - 在"执行历史"所在列单击"查看"可以查看脚本"执行情况"、"是否首批执行"、"响应内容"、"执行开始时间"、"执行结束时间"，单击"重试"可以重新执行脚本，单击"查看"，可以查看脚本响应内容，单击"下载"可以下载脚本桌面的响应内容。
    
   
   
2. 在"桌面池脚本记录"页签通过"桌面池ID"、"脚本ID"、"执行情况"、"执行开始时间"可以查看对应桌面池的"桌面池名称/ID"、"脚本名/ID"、"执行情况"、"执行详情"、"执行开始时间"、"执行结束时间"。 
   ![](https://support.huaweicloud.com/usermanual-workspace/public_sys-resources/note_3.0-zh-cn.png)
   - 在"脚本名/ID"所在列单击脚本名可以查看历史脚本详情。
   
   - 在"执行情况"所在列单击"重试"，单击"是"可以重新执行该脚本。
   
   - 在"执行详情"所在列单击"查看"可以查看对应桌面池的"桌面名称/ID"、"脚本名/ID"、"任务ID"、"执行情况"、"是否首批执行"、"响应内容"、"执行历史"、"执行开始时间"、"执行结束时间"。
     - 在"响应内容"所在列单击"查看"可以查看执行脚本桌面的响应内容，单击"下载"可以下载脚本桌面的响应内容。
     
     - 在"执行历史"所在列单击"查看"可以查看脚本"执行情况"、"是否首批执行"、"响应内容"、"执行开始时间"、"执行结束时间"，单击"重试"可以重新执行脚本，单击"查看"，可以查看脚本响应内容，单击"下载"可以下载脚本桌面的响应内容。
      
    
   
   
 
