文档首页/ 云桌面 Workspace/ API参考/ 云应用API/ 策略管理/ 修改策略组 - UpdatePolicyGroup

更新时间：2026-05-27 GMT+08:00

修改策略组 - UpdatePolicyGroup

功能介绍

修改指定策略组的信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
workspace:policyGroups:update	Write	policyGroup *	-	-	-
		user	-
		userGroup	-
		appGroup	-

URI

PATCH /v1/{project_id}/policy-groups/{policy_group_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。
policy_group_id	是	String	策略组id。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数
参数	是否必选	参数类型	描述
policy_group	是	PolicyGroupForUpdate object	修改的策略组详情。

表4 PolicyGroupForUpdate
参数	是否必选	参数类型	描述
policy_group_name	是	String	策略组名称，名称需要满足如下规则：由英文、数字或者下划线组成，不能有空格。字符长度范围1-55。
description	否	String	策略组描述。
priority	否	Integer	优先级。
targets	否	Array of Target objects	应用对象列表。
policies	否	Policies object	策略。

表5 Target
参数	是否必选	参数类型	描述
target_id	是	String	对象ID。
target_name	是	String	对象名称。
target_type	是	String	对象类型。 USER：表示用户。 USERGROUP：表示用户组。 APPGROUP：应用组。 OU：组织单元。 ALL：表示所有。 target_id：为用户ID。 target_name：为用户name。 target_id：为用户组ID。 target_name：为用户组name。 target_id：应用组id。 target_name：应用组名称。 target_id：OUID。 target_name：OU名称。 target_id：default-apply-all-targets。 target_name：All-Targets。

表6 Policies
参数	是否必选	参数类型	描述
peripherals	否	peripherals object	外设。
audio	否	audio object	音频。
client	否	client object	客户端。
display	否	display object	显示。
file_and_clipboard	否	file_and_clipboard object	文件和剪切板。
session	否	Session object	会话。
virtual_channel	否	VirtualChannel object	虚拟通道。
keyboard_mouse	否	keyboard_mouse object	键盘鼠标。
bandwidth	否	Bandwidth object	带宽。
custom	否	custom object	自定义策略。
cloud_storage	否	cloud_storage object	云存储配置。
user_profile	否	user_profile object	配置文件漫游技术配置。
url_redirection	否	url_redirection object	配置url重定向。
folder_redirection	否	folder_redirection object	配置文件夹重定向。
folder_redirection_v2	否	folder_redirection_v2 object	配置文件夹重定向(v2)。
user_profile_management	否	user_profile_management object	用户配置策略。

表7 peripherals
参数	是否必选	参数类型	描述
usb_port_redirection	否	usb_port_redirection object	USB端口重定向。
device_redirection	否	device_redirection object	设备重定向。
usb_device_common	否	usb_device_common object	USB和设备智能卡控制选项。
serial_port_redirection	否	serial_port_redirection object	串口重定向。

表8 usb_port_redirection
参数	是否必选	参数类型	描述
usb_enable	否	Boolean	是否开启USB端口重定向。取值为： false：表示关闭。 true：表示开启。
options	否	UsbPortRedirectionOptions object	USB端口重定向控制的选项。

表9 UsbPortRedirectionOptions
参数	是否必选	参数类型	描述
usb_image_enable	否	Boolean	是否开启图像设备（如: 扫描仪）。取值为： false：表示关闭。 true：表示开启。
usb_video_enable	否	Boolean	是否开启视频设备（如: 摄像头）。取值为： false：表示关闭。 true：表示开启。
usb_printer_enable	否	Boolean	是否开启打印设备（如: 打印机）。取值为： false：表示关闭。 true：表示开启。
usb_storage_enable	否	Boolean	是否开启存储设备（如: U盘）。取值为： false：表示关闭。 true：表示开启。
wireless_devices_enable	否	Boolean	是否开启无线设备（如：蓝牙）。取值为： false：表示关闭。 true：表示开启。
network_devices_enable	否	Boolean	是否开启网络设备（如：无线网卡）。取值为： false：表示关闭。 true：表示开启。
usb_smart_card_enable	否	Boolean	是否开启智能卡设备（如：Ukey）。取值为： false：表示关闭。 true：表示开启。
other_usb_devices_enable	否	Boolean	是否开启其他USB设备重定向。取值为： false：表示关闭。 true：表示开启。
usb_redirection_customization_policy	否	String	USB端口重定向自定义策略。
usb_redirection_mode	否	String	USB 重定向模式。取值为： Classical mode：经典模式。 Common mode：通用模式。

**表10** device_redirection
参数	是否必选	参数类型	描述
printer_redirection	否	printer_redirection object	打印机重定向。
session_printer	否	session_printer object	会话打印机。
camera_redirection	否	camera_redirection object	摄像头重定向。
twain_redirection_enable	否	Boolean	是否开启TWAIN设备重定向。取值为： false：表示关闭。 true：表示开启。
image_compression_level	否	String	图形压缩级别。取值为：不压缩：none。低（速度最快）：low。中（速度适中）：medium。高（速度最慢）：high。无损（无损压缩）：lossless。低损（低损压缩）：low-loss。中损（中损压缩）：medium-loss。高损（高损压缩）：high-loss。

**表11** printer_redirection
参数	是否必选	参数类型	描述
printer_enable	否	Boolean	是否开启打印机设备重定向。取值为： false：表示关闭。 true：表示开启。
options	否	PrinterRedirectionOptions object	打印机设备重定向控制的选项。

**表12** PrinterRedirectionOptions
参数	是否必选	参数类型	描述
sync_client_default_printer_enable	否	Boolean	是否开启同步客户端默认打印机。取值为： false：表示关闭。 true：表示开启。
universal_printer_driver	否	String	通用打印机驱动。取值为：- Default：linux客户端选择Universal Printing- PS，windows客户端选择HDP XPSDrv Driver。- HDP XPSDrv Driver。- Universal Printing PCL 5。- Universal Printing PCL 6。- Universal Printing PS。

**表13** session_printer
参数	是否必选	参数类型	描述
session_printer_enable	否	Boolean	是否开启会话打印机。取值为： false：表示关闭。 true：表示开启。
options	否	SessionPrinterOptions object	会话打印机控制选项。

**表14** SessionPrinterOptions
参数	是否必选	参数类型	描述
session_printer_customization_policy	否	String	会话打印机自定义策略。

**表15** camera_redirection
参数	是否必选	参数类型	描述
video_compress_enable	否	Boolean	是否开启摄像头设备重定向。取值为： false：表示关闭。 true：表示开启。
options	否	CameraRedirectionOptions object	摄像头设备重定向控制的选项。

**表16** CameraRedirectionOptions
参数	是否必选	参数类型	描述
camera_frame_rate	否	Integer	摄像头帧率（fps）。取值范围为[1-30]。默认：15。
camera_max_width	否	Integer	摄像头最大宽度（pixel）。取值范围为[1-9999]。默认：3000。
camera_max_heigth	否	Integer	摄像头最大高度（pixel）。取值范围为[1-9999]。默认：3000。
camera_compression_method	否	String	摄像头数据压缩方式。取值为：H.264。

**表17** usb_device_common
参数	是否必选	参数类型	描述
pcsc_smart_card_enable	否	String	是否开启PC/SC智能卡重定向。取值为： Enable：表示已启动。 Closed：表示已关闭。 Disable：表示已禁用。
common_options	否	common_options object	USB和设备智能卡共同控制的选项。

**表18** common_options
参数	是否必选	参数类型	描述
remove_smart_card_disconnect_enable	否	Boolean	是否移除智能卡断开用户会话。取值为： false：表示关闭。 true：表示开启。

**表19** serial_port_redirection
参数	是否必选	参数类型	描述
serial_port_enable	否	Boolean	是否开启串口重定向。取值为： false：表示关闭。 true：表示开启。
options	否	SerialPortRedirectionOptions object	串口重定向控制的选项。

**表20** SerialPortRedirectionOptions
参数	是否必选	参数类型	描述
auto_connect_enable	否	Boolean	是否自动连接客户端串口。取值为： false：表示关闭。 true：表示开启。

**表21** audio
参数	是否必选	参数类型	描述
audio_redirection_enable	否	Boolean	是否开启音频重定向。取值为： false：表示关闭。 true：表示开启。
play_redirection_enable	否	Boolean	是否开启播音重定向。取值为： false：表示关闭。 true：表示开启。
play_classification	否	String	播音场景。取值为：无损播音：LossLess。语音通话：Speech Call。音乐播音：Music Play。自动识别：Automatic Identification。
record_redirection_enable	否	Boolean	是否开启录音重定向。取值为： false：表示关闭。 true：表示开启。
record_classification	否	String	录音场景。取值为：无损录音：LossLess。语音通话：Speech Call。音乐录音：Music Record。自动识别：Automatic Identification。

**表22** client
参数	是否必选	参数类型	描述
automatic_reconnection_interval	否	Integer	自动重连间隔（秒）。取值范围为[1-50]。默认：5。
session_persistence_time	否	Integer	自动重连会话保持时长（秒）。取值范围为[0-180]。默认：180。
forbid_screen_capture	否	Boolean	防截屏策略开关。 false：表示关闭。 true：表示开启。

**表23** display
参数	是否必选	参数类型	描述
display_level	否	String	显示级别。取值为： LEVEL1：表示等级1。 LEVEL2：表示等级2。 LEVEL3：表示等级3。 LEVEL4：表示等级4（默认/推荐）。 LEVEL5：表示等级5。
options	否	DisplayOptions object	显示级别共同控制的选项。
rendering_acceleration_enable	否	Boolean	是否开启渲染加速。取值为： false：表示关闭。 true：表示开启。
rendering_acceleration_options	否	rendering_acceleration_options object	渲染加速控制选项。
video_card_memory_size	否	Integer	显卡缓存（MB）。取值范围为[0-64]。默认：64。
driver_delegation_mode_enable	否	Boolean	是否开启驱动托管模式。取值为： false：表示关闭。 true：表示开启。
driver_delegation_latency	否	Integer	驱动托管延时（*30ms）。取值范围为[1-100]。默认：80。
video_latency	否	Integer	驱动托管视频延时（*30ms）。取值范围为[1-100]。默认：80。
change_resolution_vm	否	Boolean	计算机修改分辨率：取值为： false：表示关闭。 true：表示开启。

**表24** DisplayOptions
参数	是否必选	参数类型	描述
display_bandwidth	否	Integer	带宽（Kbps）。取值范围为[256-25000]。默认：20000。
frame_rate	否	Integer	帧率（fps）。取值范围为[1-60]。默认：25。
video_frame_rate	否	Integer	视频帧率（fps）。取值范围为[1-60]。默认：30。
min_image_cache	否	Integer	图像缓存最低容量（MB）。取值范围[0-300]，默认：200。
smoothing_factor	否	Integer	有损压缩识别阈值。取值范围为[0-255]。默认：60。
lossless_compression_mode	否	String	无损压缩模式。取值为： Basic Compression：表示初级压缩。 Deep Compression：表示深度压缩。
deep_compression_options	否	deep_compression_options object	深度压缩控制选项。
lossy_compression_quality	否	Integer	有损压缩质量。取值范围为[20-100]。默认：85。
color_enhancement_enable	否	Boolean	办公场景色彩增强：取值为： false：表示关闭。 true：表示开启。
quality_bandwidth_first	否	String	质量或带宽优先。取值为： Quality First：表示初级压缩。 Bandwidth First：表示深度压缩。
video_bit_rate_options	否	video_bit_rate_options object	视频码率控制选项。
peak_video_bit_rate	否	Integer	视频峰值码率（Kbps）。取值范围为[256-100000]。默认：18000。
video_quality_options	否	video_quality_options object	视频质量控制选项。
gop_size	否	Integer	GOP大小。取值范围为[0-65535]。默认：100。
encoding_preset	否	String	编码预置。取值为：预置1：Preset 1。预置2：Preset 2。预置3：Preset 3。预置4：Preset 4。预置5：Preset 5。预置6：Preset 6。预置7：Preset 7。

**表25** deep_compression_options
参数	是否必选	参数类型	描述
deep_compression_level	否	String	深度压缩级别。取值为：压缩级别0：Compression grade 0 压缩级别1：Compression grade 1 压缩级别2：Compression grade 2 压缩级别3：Compression grade 3 压缩级别4：Compression grade 4 压缩级别5：Compression grade 5 压缩级别6：Compression grade 6 压缩级别7：Compression grade 7 压缩级别8：Compression grade 8 压缩级别9：Compression grade 9

**表26** video_bit_rate_options
参数	是否必选	参数类型	描述
average_video_bit_rate	否	Integer	视频平均码率（Kbps）。取值范围为[256-100000]。默认：18000。

**表27** video_quality_options
参数	是否必选	参数类型	描述
average_video_quality	否	Integer	视频平均质量。取值范围为[5-59]。默认：15。
lowest_video_quality	否	Integer	视频最低质量。取值范围为[5-69]。默认：25。
highest_video_quality	否	Integer	视频最高质量。取值范围为[1-59]。默认：7。

**表28** rendering_acceleration_options
参数	是否必选	参数类型	描述
video_acceleration_enhancement_enable	否	Boolean	视频加速增强配置。取值为： false：表示关闭。 true：表示开启。
video_optimization_enable	否	Boolean	是否开启视频场景优化。取值为： false：表示关闭。 true：表示开启。
gpu_color_optimization_enable	否	Boolean	是否开启GPU色彩优化。取值为： false：表示关闭。 true：表示开启。

**表29** file_and_clipboard
参数	是否必选	参数类型	描述
bypass_in_remote_app_enable	否	Boolean	应用聚合场景下是否双向放通：取值为： false：表示不放通。 true：表示放通。
file_redirection	否	file_redirection object	文件重定向。
fd_mobile_client_redir_enable	否	Boolean	移动客户端文件重定向：取值为： false：表示关闭。 true：表示开启。
clipboard_redirection	否	String	剪切板重定向。取值为： DISABLED：表示禁用。（默认） SERVER_TO_CLIENT_ENABLED：表示开启服务端到客户端。 CLIENT_TO_SERVER_ENABLED：表示开启客户端到服务端。 TWO_WAY_ENABLED：表示开启双向。
clipboard_redirection_options	否	clipboard_redirection_options object	剪切板重定向控制的选项。

**表30** file_redirection
参数	是否必选	参数类型	描述
redirection_mode	否	String	文件重定向。取值为： DISABLED：表示禁用。（默认） READ_ONLY：表示只读。 READ_AND_WRITE：表示读写。
options	否	FileRedirectionOptions object	文件重定向控制的选项。
vm_send_file_client	否	Boolean	是否开启发送文件（虚机到客户端）。取值为： false：表示关闭。 true：表示开启。
redirection_send_file_options	否	redirection_send_file_options object	重定向和发送文件共同控制项。

**表31** FileRedirectionOptions
参数	是否必选	参数类型	描述
fluid_control_switch_enable	否	Boolean	是否开启流控开关。取值为： false：表示关闭。 true：表示开启。
fluid_control_options	否	fluid_control_options object	流控控制项。
compression_switch_enable	否	Boolean	是否开启压缩开关。取值为： false：表示关闭。 true：表示开启。
compression_switch_options	否	compression_switch_options object	压缩开关控制项。
linux_file_size_supported_enable	否	Boolean	是否开启Linux支持设置文件大小。取值为： false：表示关闭。 true：表示开启。
linux_file_size_supported_options	否	linux_file_size_supported_options object	Linux支持设置文件大小控制项。
linux_root_mount_switch_enable	否	Boolean	是否开启Linux根目录挂载开关。取值为： false：表示关闭。 true：表示开启。
linux_root_dir_list	否	String	Linux根目录挂载路径。默认："\home"。
linux_file_mount_path	否	String	Linux文件系统挂载路径。默认："\media\|\Volumes\|\swdb\mnt\|\home\|\storage\|\tmp\|\run\media"。
linux_fixed_drive_file_system_format	否	String	Linux固定驱动器文件系统格式。
linux_removable_drive_file_system_format	否	String	Linux可移动驱动器文件系统格式。默认："vfat\|ntfs\|msdos\|fuseblk\|sdcardfs\|exfat\|fuse.fdredir"。
linux_cdrom_drive_file_system_format	否	String	Linux光盘驱动器文件系统格式。默认："cd9660\|iso9660\|udf"。
linux_network_drive_file_system_format	否	String	Linux网络驱动器文件系统格式。默认："smbfs\|afpfs\|cifs"。
path_separator	否	String	路径分隔符。默认："\|"。
fixed_drive_enable	否	Boolean	是否开启固定驱动器（如: 本地磁盘）。取值为： false：表示关闭。 true：表示开启。
removable_drive_enable	否	Boolean	是否开启可移除驱动器（如: U盘）。取值为： false：表示关闭。 true：表示开启。
cd_rom_drive_enable	否	Boolean	是否开启光盘驱动器。取值为： false：表示关闭。 true：表示开启。
network_drive_enable	否	Boolean	是否开启网络驱动器。取值为： false：表示关闭。 true：表示开启。

**表32** fluid_control_options
参数	是否必选	参数类型	描述
good_network_latency	否	Integer	网络优的延时阈值（ms）。取值范围为[1-1000]。默认：30。
normal_network_latency	否	Integer	网络一般的延时阈值（ms）。取值范围为[1-1000]。默认：70。
poor_network_latency	否	Integer	网络差的延时阈值（ms）。取值范围为[1-1000]。默认：100。
reducing_step	否	Integer	降速步伐（KB）。取值范围为[1-100]。默认：20。
slow_increasing_step	否	Integer	慢增速步伐（KB）。取值范围为[1-100]。默认：10。
quick_increasing_step	否	Integer	快增速步伐（KB）。取值范围为[1-100]。默认：20。
start_speed	否	Integer	传输初始速度（KB/s）。取值范围为[1-10240]。默认：1024。
test_block_size	否	Integer	测速块大小（KB）。取值范围为[64-1024]。默认：64。
test_time_gap	否	Integer	测速块时间间隔（ms）。取值范围为[1000-100000]。默认：10000。

**表33** compression_switch_options
参数	是否必选	参数类型	描述
compression_threshold	否	Integer	压缩阈值（Byte）。取值范围为[0-10240]。默认：512。
minimum_compression_rate	否	Integer	最小压缩率。取值范围为[0-1000]。默认：900。

**表34** linux_file_size_supported_options
参数	是否必选	参数类型	描述
linux_file_size_supported_threshold	否	Integer	Linux设置文件大小阈值（Byte）。取值范围为[0-4096]。默认：100。

**表35** redirection_send_file_options
参数	是否必选	参数类型	描述
read_write_speed	否	Integer	读写速度（Kbps）。取值范围为[0-2147483647]。默认：0。

**表36** clipboard_redirection_options
参数	是否必选	参数类型	描述
rich_text_redirection_enable	否	Boolean	是否开启剪切板富文本重定向。取值为： false：表示关闭。 true：表示开启。
rich_text_clipboard_redirection	否	String	剪切板富文本重定向。取值为： DISABLED：表示禁用。（默认） SERVER_TO_CLIENT_ENABLED：表示开启服务端到客户端。 CLIENT_TO_SERVER_ENABLED：表示开启客户端到服务端。 TWO_WAY_ENABLED：表示开启双向。
clipboard_file_redirection_enable	否	Boolean	是否开启剪切板文件重定向。取值为： false：表示关闭。 true：表示开启。
file_clipboard_redirection	否	String	剪切板文件重定向。取值为： DISABLED：表示禁用。（默认） SERVER_TO_CLIENT_ENABLED：表示开启服务端到客户端。 CLIENT_TO_SERVER_ENABLED：表示开启客户端到服务端。 TWO_WAY_ENABLED：表示开启双向。
clipboard_length_limit_cts_enable	否	Boolean	本地到虚拟机长度限制开关。取值为： false: 标识关闭。 ture: 标识开启。
clipboard_length_limit_cts	否	Integer	本地到虚拟机长度限制。
clipboard_length_limit_stc_enable	否	Boolean	虚拟机到本地到长度限制开关。取值为： false: 标识关闭。 ture: 标识开启。
clipboard_length_limit_stc	否	Integer	虚拟机到本地长度限制。

**表37** Session
参数	是否必选	参数类型	描述
sbc	否	Sbc object	SBC结构体。

**表38** Sbc
参数	是否必选	参数类型	描述
sbc_automatic_disconnection	否	String	连接策略： DISABLED：已禁用 AUTO_DISCONNECT：自动断开 AUTO_LOCK：自动锁屏
sbc_automatic_disconnection_options	否	SbcAutomaticDisconnectionOptions object	自动连接选项。

**表39** SbcAutomaticDisconnectionOptions
参数	是否必选	参数类型	描述
disconnection_waiting_time	否	Integer	等待时间（分钟）。
sbc_auto_logout	否	Boolean	是否自动注销。取值为：false：表示是。true：表示否。
auto_logout_options	否	AutoLogoutOptions object	自动注销。

**表40** AutoLogoutOptions
参数	是否必选	参数类型	描述
sbc_logout_waiting_time	否	Integer	会话断连保留时长（分钟）。

**表41** VirtualChannel
参数	是否必选	参数类型	描述
virtual_channel_control_enable	否	Boolean	是否开启虚拟通道策略设置。取值为：false：表示关闭。true：表示开启。
options	否	VirtualChannelOptions object	虚拟通道策略控制的选项。

**表42** VirtualChannelOptions
参数	是否必选	参数类型	描述
custom_virtual_channel_name	否	String	自定义虚拟通道注册名。
virtual_channel_plugin_details	否	String	虚拟通道下载配置信息，需Base64加密。
third_party_plugin_name	否	String	第三方插件名称。

**表43** keyboard_mouse
参数	是否必选	参数类型	描述
mouse_feedback	否	String	虚拟机鼠标回馈。取值为： SELFADAPTION：自适应鼠标回馈。 FORCE：强制鼠标回馈。 CLOSE：关闭鼠标回馈。
mouse_simulation_mode	否	String	虚拟机鼠标模拟方式。取值为： ABSOLUTE_POSITION：绝对位置模拟。 RELATIVE_POSITION：相对位置模拟。
external_cursor_feedback	否	Boolean	虚拟机外部光标反馈。取值为： false：表示关闭。 true：表示开启。

**表44** Bandwidth
参数	是否必选	参数类型	描述
intelligent_data_transport_flag	否	String	智能显示传输。取值为：DISABLE：表示关闭。ENABLE：表示开启。DIAGNOSTIC：诊断模式。
total_bandwidth_control_enable	否	Boolean	是否开启总带宽控制。取值为：false：表示关闭。true：表示开启。
options	否	TotalBandwidthControlOptions object	总带宽控制的选项。
display_bandwidth_control_enable	否	Boolean	是否开启显示带宽控制。取值为：false：表示关闭。true：表示开启。
display_bandwidth_control_options	否	DisplayBandwidthControlOptions object	显示带宽控制的选项。
multimedia_bandwidth_control_enable	否	Boolean	是否开启多媒体带宽控制。取值为：false：表示关闭。true：表示开启。
multimedia_bandwidth_control_options	否	MultimediaBandwidthControlOptions object	多媒体带宽控制的选项。
usb_bandwidth_control_enable	否	Boolean	是否开启USB带宽控制。取值为：false：表示关闭。true：表示开启。
usb_bandwidth_control_options	否	UsbBandwidthControlOptions object	USB带宽控制的选项。
pcsc_bandwidth_control_enable	否	Boolean	是否开启PCSC控制。取值为：false：表示关闭。true：表示开启。
pcsc_bandwidth_control_options	否	PcscBandwidthControlOptions object	PCSC带宽控制的选项。
twain_bandwidth_control_enable	否	Boolean	是否开启TWAIN带宽控制。取值为：false：表示关闭。true：表示开启。
twain_bandwidth_control_options	否	TwainBandwidthControlOptions object	TWAIN带宽控制的选项。
printer_bandwidth_control_enable	否	Boolean	是否开启打印机带宽控制。取值为：false：表示关闭。true：表示开启。
printer_bandwidth_control_options	否	PrinterBandwidthControlOptions object	打印机带宽控制的选项。
com_bandwidth_control_enable	否	Boolean	是否开启串口带宽控制。取值为：false：表示关闭。true：表示开启。
com_bandwidth_control_options	否	ComBandwidthControlOptions object	串口带宽控制的选项。
file_redirection_bandwidth_control_enable	否	Boolean	是否开启文件重定向带宽控制。取值为：false：表示关闭。true：表示开启。
file_redirection_bandwidth_control_options	否	FileRedirectionBandwidthControlOptions object	文件重定向带宽控制的选项。
clipboard_bandwidth_control_enable	否	Boolean	是否开启剪切板带宽控制。取值为：false：表示关闭。true：表示开启。
clipboard_bandwidth_control_options	否	ClipboardBandwidthControlOptions object	剪切板带宽控制的选项。
secure_channel_bandwidth_control_enable	否	Boolean	是否开启安全通道带宽控制。取值为：false：表示关闭。true：表示开启。
secure_channel_bandwidth_control_options	否	SecureChannelBandwidthControlOptions object	安全通道带宽控制的选项。
camera_bandwidth_control_enable	否	Boolean	是否开启摄像头带宽控制。取值为：false：表示关闭。true：表示开启。
camera_bandwidth_control_options	否	CameraBandwidthControlOptions object	摄像头带宽控制的选项。
virtual_channel_bandwidth_control_enable	否	Boolean	是否开启虚拟通道带宽控制。取值为：false：表示关闭。true：表示开启。
virtual_channel_bandwidth_control_options	否	VirtualChannelBandwidthControlOptions object	虚拟通道带宽控制的选项。

**表45** TotalBandwidthControlOptions
参数	是否必选	参数类型	描述
total_bandwidth_control_value	否	Integer	总带宽控制量（Kbps）。取值范围为[10000-1000000]。默认：30000。
display_bandwidth_percentage_enable	否	Boolean	显示带宽百分比控制。取值为：false：表示关闭。true：表示开启。
display_bandwidth_percentage_options	否	DisplayBandwidthPercentageOptions object	显示带宽百分比控制的选项。
multimedia_bandwidth_percentage_enable	否	Boolean	多媒体带宽百分比控制。取值为：false：表示关闭。true：表示开启。
multimedia_bandwidth_percentage_options	否	MultimediaBandwidthPercentageOptions object	多媒体带宽百分比控制的选项。
usb_bandwidth_percentage_enable	否	Boolean	USB带宽百分比控制。取值为：false：表示关闭。true：表示开启。
usb_bandwidth_percentage_options	否	UsbBandwidthPercentageOptions object	USB带宽百分比控制的选项。
pcsc_bandwidth_percentage_enable	否	Boolean	PCSC带宽百分比控制。取值为：false：表示关闭。true：表示开启。
pcsc_bandwidth_percentage_options	否	PcscBandwidthPercentageOptions object	PCSC带宽百分比控制的选项。
twain_bandwidth_percentage_enable	否	Boolean	TWAIN带宽百分比控制。取值为：false：表示关闭。true：表示开启。
twain_bandwidth_percentage_options	否	TwainBandwidthPercentageOptions object	TWAIN带宽百分比控制的选项。
printer_bandwidth_percentage_enable	否	Boolean	打印机带宽百分比控制。取值为：false：表示关闭。true：表示开启。
printer_bandwidth_percentage_options	否	PrinterBandwidthPercentageOptions object	打印机带宽百分比控制的选项。
com_bandwidth_percentage_enable	否	Boolean	串口带宽百分比控制。取值为：false：表示关闭。true：表示开启。
com_bandwidth_percentage_options	否	ComBandwidthPercentageOptions object	串口带宽百分比控制的选项。
file_redirection_bandwidth_percentage_enable	否	Boolean	文件重定向带宽百分比控制。取值为：false：表示关闭。true：表示开启。
file_redirection_bandwidth_percentage_options	否	FileRedirectionBandwidthPercentageOptions object	文件重定向带宽百分比控制的选项。
clipboard_bandwidth_percentage_enable	否	Boolean	剪切板带宽百分比控制。取值为：false：表示关闭。true：表示开启。
clipboard_bandwidth_percentage_options	否	ClipboardBandwidthPercentageOptions object	剪切板带宽百分比控制的选项。
secure_channel_bandwidth_percentage_enable	否	Boolean	安全通道带宽百分比控制。取值为：false：表示关闭。true：表示开启。
secure_channel_bandwidth_percentage_options	否	SecureChannelBandwidthPercentageOptions object	安全通道带宽百分比控制的选项。
camera_bandwidth_percentage_enable	否	Boolean	摄像头带宽百分比控制。取值为：false：表示关闭。true：表示开启。
camera_bandwidth_percentage_options	否	CameraBandwidthPercentageOptions object	摄像头带宽百分比控制的选项。
virtual_channel_bandwidth_percentage_enable	否	Boolean	虚拟通道带宽百分比控制。取值为：false：表示关闭。true：表示开启。
virtual_channel_bandwidth_percentage_options	否	VirtualChannelBandwidthPercentageOptions object	虚拟通道带宽百分比控制的选项。

**表46** DisplayBandwidthPercentageOptions
参数	是否必选	参数类型	描述
display_bandwidth_percentage_value	否	Integer	显示带宽百分比控制量（%）。取值范围为[0-100]。默认：65。

**表47** MultimediaBandwidthPercentageOptions
参数	是否必选	参数类型	描述
multimedia_bandwidth_percentage_value	否	Integer	多媒体带宽百分比控制量（%）。取值范围为[0-100]。默认：50。

**表48** UsbBandwidthPercentageOptions
参数	是否必选	参数类型	描述
usb_bandwidth_percentage_value	否	Integer	USB带宽百分比控制量（%）。取值范围为[0-100]。默认：100。

**表49** PcscBandwidthPercentageOptions
参数	是否必选	参数类型	描述
pcsc_bandwidth_percentage_value	否	Integer	PCSC带宽百分比控制量（%）。取值范围为[0-100]。默认：5。

**表50** TwainBandwidthPercentageOptions
参数	是否必选	参数类型	描述
twain_bandwidth_percentage_value	否	Integer	TWAIN带宽百分比控制量（%）。取值范围为[0-100]。默认：15。

**表51** PrinterBandwidthPercentageOptions
参数	是否必选	参数类型	描述
printer_bandwidth_percentage_value	否	Integer	打印机带宽百分比控制量（%）。取值范围为[0-100]。默认：5。

**表52** ComBandwidthPercentageOptions
参数	是否必选	参数类型	描述
com_bandwidth_percentage_value	否	Integer	串口带宽百分比控制量（%）。取值范围为[0-100]。默认：3。

**表53** FileRedirectionBandwidthPercentageOptions
参数	是否必选	参数类型	描述
file_redirection_bandwidth_percentage_value	否	Integer	文件重定向带宽百分比控制量（%）。取值范围为[0-100]。默认：30。

**表54** ClipboardBandwidthPercentageOptions
参数	是否必选	参数类型	描述
clipboard_bandwidth_percentage_value	否	Integer	剪切板带宽百分比控制量（%）。取值范围为[0-100]。默认：3。

**表55** SecureChannelBandwidthPercentageOptions
参数	是否必选	参数类型	描述
secure_channel_bandwidth_percentage_value	否	Integer	安全通道带宽百分比控制量（%）。取值范围为[0-100]。默认：30。

**表56** CameraBandwidthPercentageOptions
参数	是否必选	参数类型	描述
camera_bandwidth_percentage_value	否	Integer	摄像头带宽百分比控制量（%）。取值范围为[0-100]。默认：30。

**表57** VirtualChannelBandwidthPercentageOptions
参数	是否必选	参数类型	描述
virtual_channel_bandwidth_percentage_value	否	Integer	虚拟通道带宽百分比控制量（%）。取值范围为[0-100]。默认：65。

**表58** DisplayBandwidthControlOptions
参数	是否必选	参数类型	描述
display_bandwidth_control_value	否	Integer	显示带宽控制量（Kbps）。取值范围为[500-50000]。默认：20000。

**表59** MultimediaBandwidthControlOptions
参数	是否必选	参数类型	描述
multimedia_bandwidth_control_value	否	Integer	多媒体带宽控制量（Kbps）。取值范围为[5000-20000]。默认：15000。

**表60** UsbBandwidthControlOptions
参数	是否必选	参数类型	描述
usb_bandwidth_control_value	否	Integer	USB带宽控制量（Kbps）。取值范围为[1000-30000]。默认：30000。

**表61** PcscBandwidthControlOptions
参数	是否必选	参数类型	描述
pcsc_bandwidth_control_value	否	Integer	PCSC带宽控制量（Kbps）。取值范围为[1000-5000]。默认：2000。

**表62** TwainBandwidthControlOptions
参数	是否必选	参数类型	描述
twain_bandwidth_control_value	否	Integer	TWAIN带宽控制量（Kbps）。取值范围为[2000-10000]。默认：5000。

**表63** PrinterBandwidthControlOptions
参数	是否必选	参数类型	描述
printer_bandwidth_control_value	否	Integer	打印机带宽控制量（Kbps）。取值范围为[1000-5000]。默认：2000。

**表64** ComBandwidthControlOptions
参数	是否必选	参数类型	描述
com_bandwidth_control_value	否	Integer	串口带宽控制量（Kbps）。取值范围为[500-2000]。默认：1000。

**表65** FileRedirectionBandwidthControlOptions
参数	是否必选	参数类型	描述
file_redirection_bandwidth_control_value	否	Integer	文件重定向带宽控制量（Kbps）。取值范围为[500-20000]。默认：10000。

**表66** ClipboardBandwidthControlOptions
参数	是否必选	参数类型	描述
clipboard_bandwidth_control_value	否	Integer	剪切板带宽控制量（Kbps）。取值范围为[100-2000]。默认：1000。

**表67** SecureChannelBandwidthControlOptions
参数	是否必选	参数类型	描述
secure_channel_bandwidth_control_value	否	Integer	安全通道带宽控制量（Kbps）。取值范围为[500-20000]。默认：10000。

**表68** CameraBandwidthControlOptions
参数	是否必选	参数类型	描述
camera_bandwidth_control_value	否	Integer	摄像头带宽控制量（Kbps）。取值范围为[0-10000]。默认：10000。

**表69** VirtualChannelBandwidthControlOptions
参数	是否必选	参数类型	描述
virtual_channel_bandwidth_control_value	否	Integer	虚拟通道带宽控制量（Kbps）。取值范围为[500-20000]。默认：20000。

**表70** custom
参数	是否必选	参数类型	描述
custom_configuration1_enable	否	Boolean	自定义策略配置项1： false: 表示关闭 true: 表示开启
options	否	CustomOptions object	自定义策略设置项。

**表71** CustomOptions
参数	是否必选	参数类型	描述
custom_configuration1_rule	否	String	配置项1内容。
rail_transparent_config	否	RailTransparentConfig object	应用镜像策略设置项。

**表72** RailTransparentConfig
参数	是否必选	参数类型	描述
select_policy	否	Integer	策略选值原则。
transparent_list_custom	否	String	配置项内容。

**表73** cloud_storage
参数	是否必选	参数类型	描述
cloud_storage_enable	否	Boolean	云存储配置开关： false: 表示关闭 true: 表示开启
options	否	CloudStorageOptions object	云存储配置。

**表74** CloudStorageOptions
参数	是否必选	参数类型	描述
cloud_storage_rule	否	String	配置项内容。

**表75** user_profile
参数	是否必选	参数类型	描述
user_profile_enable	否	Boolean	配置文件漫游技术配置开关： false: 表示关闭 true: 表示开启
options	否	UpmOptions object	配置文件漫游技术配置。

**表76** UpmOptions
参数	是否必选	参数类型	描述
user_profile_rule	否	String	配置项内容。
redir_exclude_common_folders	否	String	排除常用文件夹。
redir_exclude_copy0s	否	String	禁止自定义文件夹/copy base = 0,copy back = 0。
redir_exclude_copy1s	否	String	禁止自定义文件夹/copy base = 0,copy back = 1。
redir_exclude_copy2s	否	String	禁止自定义文件夹/copy base = 1,copy back = 0。
redir_exclude_copy3s	否	String	禁止自定义文件夹/copy base = 1,copy back = 1。
redir_exclude_includes	否	String	允许自定义文件夹

**表77** url_redirection
参数	是否必选	参数类型	描述
url_redirection_enable	否	Boolean	配置url重定向开关： false: 表示关闭 true: 表示开启
options	否	UrlRedirectionOptions object	url重定向配置。

**表78** UrlRedirectionOptions
参数	是否必选	参数类型	描述
url_include_list	否	String	允许重定向url。
url_exclude_list	否	String	拒绝重定向url。

**表79** folder_redirection
参数	是否必选	参数类型	描述
folder_redirection_status	否	Integer	配置文件夹重定向状态： 0: 已禁用 1: 已启用 2: 未配置
options	否	FolderRedirectionOptions object	文件夹重定向配置。

**表80** FolderRedirectionOptions
参数	是否必选	参数类型	描述
relative_path	否	String	目标文件夹位置。
storage_paths	否	String	用户存储路径。
include_common_folders	否	Integer	文件夹选项。

**表81** folder_redirection_v2
参数	是否必选	参数类型	描述
folder_redirection_v2_status	否	Integer	配置文件夹重定向状态： 0: 关闭 1: 已启用
options	否	FolderRedirectionV2Options object	文件夹重定向配置(v2)。

**表82** FolderRedirectionV2Options
参数	是否必选	参数类型	描述
app_data_roaming_configurations	否	AppDataRoamingConfigurations object	“AppData(Roaming)”文件夹重定向配置
desktop_configurations	否	DesktopConfigurations object	“桌面”文件夹重定向配置
start_menu_configurations	否	StartMenuConfigurations object	“开始菜单”文件夹重定向配置
documents_configurations	否	DocumentsConfigurations object	“文档”文件夹重定向配置
pictures_configurations	否	PicturesConfigurations object	“图片”文件夹重定向配置
music_configurations	否	MusicConfigurations object	“音乐”文件夹重定向配置
videos_configurations	否	VideosConfigurations object	“视频”文件夹重定向配置
favorites_configurations	否	FavoritesConfigurations object	“收藏夹”文件夹重定向配置
contacts_configurations	否	ContactsConfigurations object	“联系人”文件夹重定向配置
downloads_configurations	否	DownloadsConfigurations object	“下载”文件夹重定向配置
links_configurations	否	LinksConfigurations object	“链接”文件夹重定向配置
searches_configurations	否	SearchesConfigurations object	“搜索”文件夹重定向配置
saved_games_configurations	否	SavedGamesConfigurations object	“保存的游戏”文件夹重定向配置

**表83** AppDataRoamingConfigurations
参数	是否必选	参数类型	描述
app_data_roaming_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
app_data_roaming_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
app_data_roaming_storage_path	否	String	文件夹重定向(v2)用户存储路径。
app_data_roaming_relative_path	否	String	目标文件夹位置。
app_data_roaming_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
app_data_roaming_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
app_data_roaming_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表84** DesktopConfigurations
参数	是否必选	参数类型	描述
desktop_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
desktop_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
desktop_storage_path	否	String	文件夹重定向(v2)用户存储路径。
desktop_relative_path	否	String	目标文件夹位置。
desktop_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
desktop_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
desktop_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表85** StartMenuConfigurations
参数	是否必选	参数类型	描述
start_menu_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
start_menu_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
start_menu_storage_path	否	String	文件夹重定向(v2)用户存储路径。
start_menu_relative_path	否	String	目标文件夹位置。
start_menu_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
start_menu_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
start_menu_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表86** DocumentsConfigurations
参数	是否必选	参数类型	描述
documents_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
documents_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
documents_storage_path	否	String	文件夹重定向(v2)用户存储路径。
documents_relative_path	否	String	目标文件夹位置。
documents_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
documents_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
documents_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表87** PicturesConfigurations
参数	是否必选	参数类型	描述
pictures_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
pictures_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
pictures_storage_path	否	String	文件夹重定向(v2)用户存储路径。
pictures_relative_path	否	String	目标文件夹位置。
pictures_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
pictures_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
pictures_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表88** MusicConfigurations
参数	是否必选	参数类型	描述
music_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
music_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
music_storage_path	否	String	文件夹重定向(v2)用户存储路径。
music_relative_path	否	String	目标文件夹位置。
music_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
music_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
music_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表89** VideosConfigurations
参数	是否必选	参数类型	描述
videos_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
videos_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
videos_storage_path	否	String	文件夹重定向(v2)用户存储路径。
videos_relative_path	否	String	目标文件夹位置。
videos_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
videos_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
videos_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表90** FavoritesConfigurations
参数	是否必选	参数类型	描述
favorites_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
favorites_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
favorites_storage_path	否	String	文件夹重定向(v2)用户存储路径。
favorites_relative_path	否	String	目标文件夹位置。
favorites_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
favorites_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
favorites_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表91** ContactsConfigurations
参数	是否必选	参数类型	描述
contacts_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
contacts_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
contacts_storage_path	否	String	文件夹重定向(v2)用户存储路径。
contacts_relative_path	否	String	目标文件夹位置。
contacts_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
contacts_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
contacts_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表92** DownloadsConfigurations
参数	是否必选	参数类型	描述
downloads_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
downloads_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
downloads_storage_path	否	String	文件夹重定向(v2)用户存储路径。
downloads_relative_path	否	String	目标文件夹位置。
downloads_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
downloads_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
downloads_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表93** LinksConfigurations
参数	是否必选	参数类型	描述
links_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
links_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
links_storage_path	否	String	文件夹重定向(v2)用户存储路径。
links_relative_path	否	String	目标文件夹位置。
links_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
links_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
links_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表94** SearchesConfigurations
参数	是否必选	参数类型	描述
searches_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
searches_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
searches_storage_path	否	String	文件夹重定向(v2)用户存储路径。
searches_relative_path	否	String	目标文件夹位置。
searches_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
searches_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
searches_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表95** SavedGamesConfigurations
参数	是否必选	参数类型	描述
saved_games_status	否	Integer	配置文件夹重定向状态： 0: 未选取 1: 已选取
saved_games_redirection_type	否	Integer	配置文件夹重定向类型： 0: 远程 1: 本地
saved_games_storage_path	否	String	文件夹重定向(v2)用户存储路径。
saved_games_relative_path	否	String	目标文件夹位置。
saved_games_exclusive_rights	否	Integer	是否开启用户对该文件夹的独占控制权限： 0: 禁用 1: 开启
saved_games_move_contents	否	Integer	启用文件夹重定向策略时，是否将现有内容移动到新位置： 0: 否 1: 是
saved_games_move_content_on_policy_removal	否	Integer	禁用或删除策略时，是否将内容移回本地用户配置文件位置： 0: 否 1: 是

**表96** user_profile_management
参数	是否必选	参数类型	描述
upm_status	否	Integer	用户配置状态： 0: 已禁用 1: 已启用 2: 未配置
options	否	UserProfileManagementOptions object	用户漫游配置。

**表97** UserProfileManagementOptions
参数	是否必选	参数类型	描述
profiles	否	UserProfileManagementProfiles object	用户漫游profiles配置。

**表98** UserProfileManagementProfiles
参数	是否必选	参数类型	描述
vhd_write_back	否	String	配置VHD会话回写状态： 0: 已禁用 1: 已启用 2: 未配置

响应参数

状态码：200

**表99** 响应Body参数
参数	参数类型	描述
id	String	被修改策略主键。

状态码：400

**表100** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：401

**表101** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：403

**表102** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：404

**表103** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：405

**表104** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：500

**表105** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

状态码：503

**表106** 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述。

请求示例

PATCH /v1/29dfe82ada564ac2b927e1ff036d9a9b/policy-groups/1d23e82ada564ac2b927e1ff0361fe23

{
  "policy_group" : {
    "policy_group_name" : "aaa",
    "description" : "",
    "policies" : {
      "peripherals" : {
        "usb_port_redirection" : {
          "usb_enable" : true,
          "options" : {
            "usb_image_enable" : true,
            "usb_video_enable" : true,
            "usb_printer_enable" : true,
            "usb_storage_enable" : false,
            "wireless_devices_enable" : false,
            "network_devices_enable" : false,
            "usb_smart_card_enable" : true,
            "other_usb_devices_enable" : false,
            "usb_redirection_customization_policy" : "",
            "usb_redirection_mode" : "Classical mode"
          }
        },
        "device_redirection" : {
          "printer_redirection" : {
            "printer_enable" : true,
            "options" : {
              "sync_client_default_printer_enable" : true,
              "universal_printer_driver" : "Default"
            }
          },
          "session_printer" : {
            "session_printer_enable" : false,
            "options" : {
              "session_printer_customization_policy" : ""
            }
          },
          "camera_redirection" : {
            "video_compress_enable" : true,
            "options" : {
              "camera_frame_rate" : 15,
              "camera_max_width" : 3000,
              "camera_max_heigth" : 3000,
              "camera_compression_method" : "H.264"
            }
          },
          "twain_redirection_enable" : true,
          "image_compression_level" : "medium"
        },
        "usb_device_common" : {
          "pcsc_smart_card_enable" : "Disable",
          "common_options" : {
            "remove_smart_card_disconnect_enable" : false
          }
        },
        "serial_port_redirection" : {
          "serial_port_enable" : false,
          "options" : {
            "auto_connect_enable" : false
          }
        }
      },
      "audio" : {
        "audio_redirection_enable" : true,
        "play_redirection_enable" : true,
        "play_classification" : "Music Play",
        "record_redirection_enable" : true,
        "record_classification" : "Speech Call"
      },
      "client" : {
        "automatic_reconnection_interval" : 5,
        "session_persistence_time" : 180,
        "forbid_screen_capture" : false
      },
      "display" : {
        "display_level" : "LEVEL4",
        "options" : {
          "display_bandwidth" : 20000,
          "frame_rate" : 60,
          "video_frame_rate" : 60,
          "min_image_cache" : 200,
          "smoothing_factor" : 60,
          "lossless_compression_mode" : "Basic Compression",
          "deep_compression_options" : {
            "deep_compression_level" : "Compression grade 0"
          },
          "lossy_compression_quality" : 85,
          "color_enhancement_enable" : false,
          "quality_bandwidth_first" : "Bandwidth First",
          "video_bit_rate_options" : {
            "average_video_bit_rate" : 18000
          },
          "peak_video_bit_rate" : 18000,
          "video_quality_options" : {
            "average_video_quality" : 15,
            "lowest_video_quality" : 25,
            "highest_video_quality" : 7
          },
          "gop_size" : 100,
          "encoding_preset" : "Preset 1"
        },
        "rendering_acceleration_enable" : true,
        "rendering_acceleration_options" : {
          "video_acceleration_enhancement_enable" : true,
          "video_optimization_enable" : true,
          "gpu_color_optimization_enable" : true
        },
        "video_card_memory_size" : 64,
        "driver_delegation_mode_enable" : false,
        "driver_delegation_latency" : 80,
        "video_latency" : 80,
        "change_resolution_vm" : false
      },
      "file_and_clipboard" : {
        "bypass_in_remote_app_enable" : true,
        "file_redirection" : {
          "redirection_mode" : "DISABLED",
          "options" : {
            "fluid_control_switch_enable" : false,
            "fluid_control_options" : {
              "good_network_latency" : 30,
              "normal_network_latency" : 70,
              "poor_network_latency" : 100,
              "reducing_step" : 20,
              "slow_increasing_step" : 10,
              "quick_increasing_step" : 20,
              "start_speed" : 1024,
              "test_block_size" : 64,
              "test_time_gap" : 10000
            },
            "compression_switch_enable" : false,
            "compression_switch_options" : {
              "compression_threshold" : 512,
              "minimum_compression_rate" : 900
            },
            "linux_file_size_supported_enable" : true,
            "linux_file_size_supported_options" : {
              "linux_file_size_supported_threshold" : 100
            },
            "linux_root_mount_switch_enable" : true,
            "linux_root_dir_list" : "\\var\\log",
            "linux_file_mount_path" : "\\media|\\Volumes|\\swdb\\mnt|\\home|\\storage|\\tmp|\\run\\media",
            "linux_fixed_drive_file_system_format" : "",
            "linux_removable_drive_file_system_format" : "vfat|ntfs|msdos|fuseblk|sdcardfs|exfat|fuse.fdredir",
            "linux_cdrom_drive_file_system_format" : "cd9660|iso9660|udf",
            "linux_network_drive_file_system_format" : "smbfs|afpfs|cifs",
            "path_separator" : "|",
            "fixed_drive_enable" : true,
            "removable_drive_enable" : true,
            "cd_rom_drive_enable" : true,
            "network_drive_enable" : true
          },
          "vm_send_file_client" : false,
          "redirection_send_file_options" : {
            "read_write_speed" : 0
          }
        },
        "fd_mobile_client_redir_enable" : true,
        "clipboard_redirection" : "DISABLED",
        "clipboard_redirection_options" : {
          "rich_text_redirection_enable" : true,
          "rich_text_clipboard_redirection" : "DISABLED",
          "clipboard_file_redirection_enable" : true,
          "file_clipboard_redirection" : "DISABLED",
          "clipboard_length_limit_cts_enable" : false,
          "clipboard_length_limit_cts" : 1,
          "clipboard_length_limit_stc_enable" : false,
          "clipboard_length_limit_stc" : 1
        }
      },
      "session" : {
        "sbc" : {
          "sbc_automatic_disconnection" : "AUTO_DISCONNECT",
          "sbc_automatic_disconnection_options" : {
            "disconnection_waiting_time" : 15,
            "sbc_auto_logout" : true,
            "auto_logout_options" : {
              "sbc_logout_waiting_time" : 60
            }
          }
        }
      },
      "virtual_channel" : {
        "virtual_channel_control_enable" : false,
        "options" : {
          "custom_virtual_channel_name" : "",
          "virtual_channel_plugin_details" : "",
          "third_party_plugin_name" : ""
        }
      },
      "keyboard_mouse" : {
        "mouse_feedback" : "SELFADAPTION",
        "mouse_simulation_mode" : "ABSOLUTE_POSITION",
        "external_cursor_feedback" : false
      },
      "bandwidth" : {
        "intelligent_data_transport_flag" : "DISABLE",
        "total_bandwidth_control_enable" : false,
        "options" : {
          "total_bandwidth_control_value" : 30000,
          "display_bandwidth_percentage_enable" : false,
          "display_bandwidth_percentage_options" : {
            "display_bandwidth_percentage_value" : 65
          },
          "multimedia_bandwidth_percentage_enable" : false,
          "multimedia_bandwidth_percentage_options" : {
            "multimedia_bandwidth_percentage_value" : 50
          },
          "usb_bandwidth_percentage_enable" : false,
          "usb_bandwidth_percentage_options" : {
            "usb_bandwidth_percentage_value" : 100
          },
          "pcsc_bandwidth_percentage_enable" : false,
          "pcsc_bandwidth_percentage_options" : {
            "pcsc_bandwidth_percentage_value" : 5
          },
          "twain_bandwidth_percentage_enable" : false,
          "twain_bandwidth_percentage_options" : {
            "twain_bandwidth_percentage_value" : 15
          },
          "printer_bandwidth_percentage_enable" : false,
          "printer_bandwidth_percentage_options" : {
            "printer_bandwidth_percentage_value" : 5
          },
          "com_bandwidth_percentage_enable" : false,
          "com_bandwidth_percentage_options" : {
            "com_bandwidth_percentage_value" : 3
          },
          "file_redirection_bandwidth_percentage_enable" : false,
          "file_redirection_bandwidth_percentage_options" : {
            "file_redirection_bandwidth_percentage_value" : 30
          },
          "clipboard_bandwidth_percentage_enable" : false,
          "clipboard_bandwidth_percentage_options" : {
            "clipboard_bandwidth_percentage_value" : 3
          },
          "secure_channel_bandwidth_percentage_enable" : false,
          "secure_channel_bandwidth_percentage_options" : {
            "secure_channel_bandwidth_percentage_value" : 30
          },
          "camera_bandwidth_percentage_enable" : false,
          "camera_bandwidth_percentage_options" : {
            "camera_bandwidth_percentage_value" : 30
          },
          "virtual_channel_bandwidth_percentage_enable" : false,
          "virtual_channel_bandwidth_percentage_options" : {
            "virtual_channel_bandwidth_percentage_value" : 65
          }
        },
        "display_bandwidth_control_enable" : false,
        "display_bandwidth_control_options" : {
          "display_bandwidth_control_value" : 20000
        },
        "multimedia_bandwidth_control_enable" : false,
        "multimedia_bandwidth_control_options" : {
          "multimedia_bandwidth_control_value" : 15000
        },
        "usb_bandwidth_control_enable" : false,
        "usb_bandwidth_control_options" : {
          "usb_bandwidth_control_value" : 30000
        },
        "pcsc_bandwidth_control_enable" : false,
        "pcsc_bandwidth_control_options" : {
          "pcsc_bandwidth_control_value" : 2000
        },
        "twain_bandwidth_control_enable" : false,
        "twain_bandwidth_control_options" : {
          "twain_bandwidth_control_value" : 5000
        },
        "printer_bandwidth_control_enable" : false,
        "printer_bandwidth_control_options" : {
          "printer_bandwidth_control_value" : 2000
        },
        "com_bandwidth_control_enable" : false,
        "com_bandwidth_control_options" : {
          "com_bandwidth_control_value" : 1000
        },
        "file_redirection_bandwidth_control_enable" : false,
        "file_redirection_bandwidth_control_options" : {
          "file_redirection_bandwidth_control_value" : 10000
        },
        "clipboard_bandwidth_control_enable" : false,
        "clipboard_bandwidth_control_options" : {
          "clipboard_bandwidth_control_value" : 1000
        },
        "secure_channel_bandwidth_control_enable" : false,
        "secure_channel_bandwidth_control_options" : {
          "secure_channel_bandwidth_control_value" : 10000
        },
        "camera_bandwidth_control_enable" : false,
        "camera_bandwidth_control_options" : {
          "camera_bandwidth_control_value" : 10000
        },
        "virtual_channel_bandwidth_control_enable" : false,
        "virtual_channel_bandwidth_control_options" : {
          "virtual_channel_bandwidth_control_value" : 20000
        }
      },
      "custom" : {
        "custom_configuration1_enable" : true,
        "options" : {
          "custom_configuration1_rule" : "",
          "rail_transparent_config" : {
            "select_policy" : 0,
            "transparent_list_custom" : ""
          }
        }
      },
      "cloud_storage" : {
        "cloud_storage_enable" : true,
        "options" : {
          "cloud_storage_rule" : "{\"personal_folder\":{\"storage_paths\":[{\"storage_type\":\"HUAWEI_CLOUD_SFS\",\"project_config_id\":\"\"}]},\"shared_folder\":{}}"
        }
      },
      "user_profile" : {
        "user_profile_enable" : true,
        "options" : {
          "user_profile_rule" : "{\"ProfileEnable\":{\"status\":1,\"value\":0},\"ProfileLocations\":{\"status\":1,\"type\":\"SMBLocation\",\"user_profile_locations\":[{\"id\":0,\"container_type\":\"HUAWEI_CLOUD_SFS\",\"path\":\"\"}]},\"ProfileVhdType\":{\"status\":1,\"value\":\"vhdx\"},\"ProfileIsDynamic\":{\"status\":1,\"value\":1},\"ProfileVhdFileSize\":{\"status\":1,\"value\":30000},\"ProfileDiffDiskParentFolderPath\":{\"status\":2,\"value\":\"%TEMP%\"},\"ProfileSidDirNameRule\":{\"status\":2,\"value\":\"%sid%_%username%\"},\"ProfileSidDirMatchRule\":{\"status\":2,\"value\":\"%sid%_%username%\"},\"ProfileVhdFileNameRule\":{\"status\":2,\"value\":\"Profile_%username%\"},\"ProfileVhdFileMatchRule\":{\"status\":2,\"value\":\"Profile*\"},\"ProfileNoProfileContainingFolder\":{\"status\":2,\"value\":0},\"ProfileFlipFlopProfileDirectoryName\":{\"status\":2,\"value\":0},\"ProfileRemoveOrphanedOSTFilesOnLogoff\":{\"status\":2,\"value\":0},\"ProfileVolumeWaitTimeMS\":{\"status\":2,\"value\":20000},\"ProfileVHDXSectorSize\":{\"status\":2,\"value\":0},\"ProfileRebootOnUserLogoff\":{\"status\":2,\"value\":0},\"ProfileRedirectType\":{\"status\":2,\"value\":2},\"ProfileSetTempToLocalPath\":{\"status\":2,\"value\":3},\"ProfileRoamSearch\":{\"status\":2,\"value\":0},\"ProfileLockedRetryInterval\":{\"status\":2,\"value\":5},\"ProfileVhdAttachedRetryTimes\":{\"status\":2,\"value\":60},\"ProfileShutdownOnUserLogoff\":{\"status\":2,\"value\":0},\"ProfileOutlookCachedMode\":{\"status\":2,\"value\":1},\"ProfileKeepLocalDir\":{\"status\":2,\"value\":0},\"ProfilePreventLoginWithFailure\":{\"status\":2,\"value\":0},\"ProfileDirSDDL\":{\"status\":2,\"value\":\"N/A\"},\"ProfileRedirXmlLocation\":{\"status\":2,\"value\":\"N/A\"},\"ProfileAttachVHDSDDL\":{\"status\":2,\"value\":\"N/A\"},\"ProfileDeleteLocalProfile\":{\"status\":2,\"value\":0},\"ProfileInstallAppxPackages\":{\"status\":2,\"value\":1},\"ProfilePreventLoginWithTempProfile\":{\"status\":2,\"value\":0},\"ProfileVhdReattachInterval\":{\"status\":2,\"value\":10},\"SIDDirSDDL\":{\"status\":2,\"value\":\"N/A\"},\"ProfileCleanOutNotifications\":{\"status\":2,\"value\":1},\"ProfileRoamIdentity\":{\"status\":2,\"value\":0},\"ProfileAccessNetworkAsComputerObject\":{\"status\":2,\"value\":0},\"ProfileType\":{\"status\":2,\"value\":0},\"ProfileLockedRetryCount\":{\"status\":2,\"value\":12},\"ODFCEnable\":{\"status\":1,\"value\":0},\"ODFCLocations\":{\"status\":1,\"type\":\"SMBLocation\",\"user_profile_locations\":[{\"id\":0,\"container_type\":\"HUAWEI_CLOUD_SFS\",\"path\":\"\"}]},\"ODFCVHDType\":{\"status\":1,\"value\":\"vhdx\"},\"ODFCIsDynamic\":{\"status\":1,\"value\":1},\"ODFCVHDFileSize\":{\"status\":1,\"value\":30000},\"ODFCVHDNamePattern\":{\"status\":2,\"value\":\"ODFC_%username%\"},\"ODFCSIDDirNamePattern\":{\"status\":2,\"value\":\"%sid%_%username%\"},\"ODFCSIDDirNameMatch\":{\"status\":2,\"value\":\"%sid%_%username%\"},\"ODFCDiffDiskParentFolderPath\":{\"status\":2,\"value\":\"%TEMP%\"},\"ODFCFlipFlopProfileDirectoryName\":{\"status\":2,\"value\":0},\"ODFCVHDNameMatch\":{\"status\":2,\"value\":\"ODFC*\"},\"ODFCNoProfileContainingFolder\":{\"status\":2,\"value\":0},\"IncludeOfficeActivation\":{\"status\":2,\"value\":1},\"IncludeOneNote\":{\"status\":2,\"value\":0},\"ODFCVHDXSectorSize\":{\"status\":2,\"value\":0},\"OutlookFolderPath\":{\"status\":2,\"value\":\"%userprofile%\\\\AppData\\\\Local\\\\Microsoft\\\\Outlook\"},\"ODFCVolumeWaitTimeMS\":{\"status\":2,\"value\":20000},\"IncludeOutlookPersonalization\":{\"status\":2,\"value\":1},\"ODFCVHDReAttachIntervalSeconds\":{\"status\":2,\"value\":10},\"ODFCMirrorLocalOSTToVHD\":{\"status\":2,\"value\":0},\"ODFCIncludeTeams\":{\"status\":2,\"value\":0},\"ODFCRemoveOrphanedOSTFilesOnLogoff\":{\"status\":2,\"value\":0},\"ODFCVHDReAttachRetryCount\":{\"status\":2,\"value\":60},\"ODFCLockedRetryInterval\":{\"status\":2,\"value\":5},\"ODFCIncludeOneNote_UWP\":{\"status\":2,\"value\":0},\"ODFCRedirectType\":{\"status\":2,\"value\":2},\"ODFCLockedRetryCount\":{\"status\":2,\"value\":12},\"IncludeOneDrive\":{\"status\":2,\"value\":1},\"ODFCRefreshUserPolicy\":{\"status\":2,\"value\":0},\"IncludeSkype\":{\"status\":2,\"value\":1},\"ODFCRoamSearch\":{\"status\":2,\"value\":0},\"OutlookCachedMode\":{\"status\":2,\"value\":1},\"ODFCIncludeSharepoint\":{\"status\":2,\"value\":1},\"IncludeOutlook\":{\"status\":2,\"value\":1},\"ODFCAttachVHDSDDL\":{\"status\":2,\"value\":\"N/A\"},\"ODFCAccessNetworkAsComputerObject\":{\"status\":2,\"value\":0},\"ODFCPreventLoginWithTempProfile\":{\"status\":2,\"value\":0},\"ODFCPreventLoginWithFailure\":{\"status\":2,\"value\":0},\"ODFCNumSessionVHDsToKeep\":{\"status\":2,\"value\":2},\"ODFCVHDAccessMode\":{\"status\":2,\"value\":0},\"CacheEnable\":{\"status\":1,\"value\":0},\"CacheDirectory\":{\"status\":2,\"value\":\"C:\\\\ProgramData\\\\FSLogix\\\\Cache\"},\"WriteCacheDirectory\":{\"status\":2,\"value\":\"C:\\\\ProgramData\\\\FSLogix\\\\Cache\"},\"ProxyDirectory\":{\"status\":2,\"value\":\"C:\\\\ProgramData\\\\FSLogix\\\\Proxy\"},\"ProfileCcdUnregisterTimeout\":{\"status\":2,\"value\":0},\"ProfileHealthyProvidersRequiredForRegister\":{\"status\":2,\"value\":0},\"ProfileHealthyProvidersRequiredForUnregister\":{\"status\":2,\"value\":1},\"ProfileClearCacheOnLogoff\":{\"status\":2,\"value\":0},\"ProfileClearCacheOnForcedUnregister\":{\"status\":2,\"value\":0},\"ODFCClearCacheOnForcedUnregister\":{\"status\":2,\"value\":0},\"ODFCClearCacheOnLogoff\":{\"status\":2,\"value\":0},\"ODFCHealthyProvidersRequiredForRegister\":{\"status\":2,\"value\":0},\"ODFCHealthyProvidersRequiredForUnregister\":{\"status\":2,\"value\":1},\"ODFCCcdUnregisterTimeout\":{\"status\":2,\"value\":0},\"LoggingEnabled\":{\"status\":1,\"value\":2},\"LogLevel\":{\"status\":1,\"value\":1},\"LogFileKeepingPeriod\":{\"status\":1,\"value\":7},\"LogLocation\":{\"status\":1,\"value\":\"%ProgramData%\\\\FSLogix\\\\Logs\"},\"RobocopyLogPath\":{\"status\":1,\"value\":\"\"},\"DriverInterface\":{\"status\":1,\"value\":0},\"RuleCompilation\":{\"status\":1,\"value\":0},\"ProcessStart\":{\"status\":1,\"value\":0},\"LoggingProfile\":{\"status\":1,\"value\":1},\"LoggingService\":{\"status\":1,\"value\":0},\"LoggingPrinter\":{\"status\":1,\"value\":0},\"LoggingFont\":{\"status\":1,\"value\":0},\"ConfigTool\":{\"status\":1,\"value\":1},\"LoggingODFC\":{\"status\":1,\"value\":0},\"AdsComputerGroup\":{\"status\":1,\"value\":0},\"LoggingNetwork\":{\"status\":1,\"value\":0},\"LoggingSearch\":{\"status\":1,\"value\":1},\"FrxLauncher\":{\"status\":1,\"value\":0},\"SearchPlugin\":{\"status\":1,\"value\":0}}",
          "redir_exclude_common_folders" : "{\"status\":1,\"value\":0}",
          "redir_exclude_copy0s" : "[]",
          "redir_exclude_copy1s" : "[]",
          "redir_exclude_copy2s" : "[]",
          "redir_exclude_copy3s" : "[]",
          "redir_exclude_includes" : "[]"
        }
      },
      "url_redirection" : {
        "url_redirection_enable" : false,
        "options" : {
          "url_exclude_list" : "[]",
          "url_include_list" : "[{\"id\":\"testf682f5fb43etestf9ea68d4e026a\",\"status\":1,\"value\":\"http://*\"},{\"id\":\"testf682f5fb43etestcd9c2d3bc14ac14\",\"status\":1,\"value\":\"https://*\"}]"
        }
      },
      "folder_redirection" : {
        "folder_redirection_status" : 2,
        "options" : {
          "relative_path" : "",
          "storage_paths" : "{\"storage_type\":\"HUAWEI_CLOUD_SFS\",\"project_config_id\":\"\"}",
          "include_common_folders" : 0
        }
      },
      "user_profile_management" : {
        "upm_status" : 1,
        "options" : {
          "profiles" : {
            "vhd_write_back" : "{\"status\":2,\"value\":0}"
          }
        }
      }
    }
  }
}

响应示例

状态码：200

成功响应。

{
  "id" : "2c9080c97f310b73017f3f9501070043"
}

状态码

状态码	描述
200	成功响应。
400	由于包含语法错误，当前请求无法被服务器理解。
401	鉴权失败。
403	没有操作权限。
404	找不到资源。
405	请求中指定的方法不被允许。
500	服务内部错误，具体返回错误码请参见错误码说明。
503	服务不可用。