箴更新的API
Pro更新API提供了检查，下载和应用最新的Metasploit Pro更新的功能。该API还包括用于重新启动Metasploit Pro服务的方法。
pro.update_available
pro.update_available方法提供了检查Metasploit Pro实例的可用更新的功能。UpdateCheckOptions Hash可以为空或包含“proxy_host”，'proxy_port'，'proxy_user'和'proxy_pass'元素以使用HTTP代理进行检查。返回值包括一个散列，指示更新是否可用，此更新的版本号是什么，以及更新包含的内容。请注意，说明可能包含HTML格式。
请求示例
贝壳
1
[“pro.update_available”那“<令牌>”那{}]
反应的例子
杰森
1
{
2
“地位”＝＞“成功”那
3.
“结果”＝＞“更新”那
4.
“当前的”＝＞“1”那
5.
“版本”＝＞“20120125000001”那
6.
“信息”＝＞“这次更新增加了新功能和修复……”
7.
}
pro.update_install
箴。update_install方法提供按名称安装更新包的能力，该名称通过InstallOptions散列的'version'元素指定。在这个散列中可以提供'proxy_host'， 'proxy_port'， 'proxy_user'和'proxy_pass'元素，以指示应该使用HTTP代理。此方法返回一个散列，指示更新是否已成功启动以及安装的当前状态。下载和安装过程是一个简单的步骤，可以通过调用pro来跟踪进度。update_status方法。注意专业人士。必须调用Restart_service方法来完成更新。
请求示例
贝壳
1
[“pro.update_install”那“<令牌>”那{“版本”=>“20120125000001”}]
反应的例子
杰森
1
{
2
“地位”＝＞“成功”那
3.
“结果”＝＞“下载”那
4.
“错误”＝＞“
5.
}
pro.update_install_offline
箴。Update_install_offline方法提供从本地文件系统安装更新包的能力。需要离线更新的客户应联系Rapid7支持，以获得每个更新包的下载位置通知。离线包安装的状态可以通过调用pro来监控。update_status方法。注意专业人士。必须调用Restart_service方法来完成更新。
请求示例
贝壳
1
[“pro.update_install_offline”那“<令牌>”那“/tmp/metasploit_pro_update.zip”]
反应的例子
杰森
1
{
2
“地位”＝＞“成功”那
3.
“结果”＝＞“安装”那
4.
“错误”＝＞“
5.
}
pro.update_status
箴。Update_status方法返回一个哈希值，该哈希值指示更新安装过程的当前状态。如果仍在从服务器检索更新，则下载的当前进度将在'download_total'、'download_done'和'download_pcnt'元素中返回。
请求示例
贝壳
1
[“pro.update_status”那“<令牌>”]
反应的例子
杰森
1
{
2
“地位”＝＞“成功”那
3.
“结果”＝＞“下载”那
4.
“错误”＝＞“那
5.
“download_total”＝＞“1000000”那
6.
“download_done”＝＞“100000”那
7.
“download_pcnt”＝＞“10”
8.
}
pro.update_stop.
pro.update_stop方法强制停止任何现有的更新过程，无论是下载更新包还是安装内容。
请求示例
贝壳
1
[“pro.update_stop”那“<令牌>”]
反应的例子
杰森
1
{“地位”＝＞“成功”}
pro.restart_service
箴。restart_service方法会导致Metasploit Pro RPC Service (prosvc)和Metasploit Pro Web Service重新启动。这是完成更新包安装所必需的。
请求示例
贝壳
1
[“pro.restart_service”那“<令牌>”]
反应的例子
杰森
1
{“地位”＝＞“成功”}