使用 Windows 部署服务客户端 API

在标准Windows部署服务 (WDS) 解决方案不能用于安装Windows的环境中,WDS 客户端的 API 使开发人员能够编写自定义部署应用程序。 应用程序可以使用此 API 与 WDS 服务器通信,以获取有关服务器中可用的系统映像的信息。 自定义 WDS 客户端应用程序应遵循以下准则。

在服务器上安装 WDS 角色

  • Windows部署服务 (WDS) 是远程安装服务 (RIS) 的修订版本,你需要服务器上的 WDS 服务器角色来实现自定义 WDS 客户端解决方案。
  • WDS 将 RIS 替换为标准组件,从 Windows Server 2008 开始,Windows Server 2003 替换为 Service Pack 2 (SP2) 。
  • 必须使用 Service Pack 1 (SP1) 将 RIS 服务器更新到 Windows Server 2003 上的 WDS。 可以使用Windows自动安装工具包 (WAIK) 安装 WDS 服务器角色。

"开始"菜单 Windows PE 2.0

Windows PE 2.0 必须启动(如果尚未启动)。 仅当 WDS 客户端和支持 DLL 位于 Microsoft Windows 预安装环境 (Windows PE 2.0) 安装阶段时,setup.exe才会加载该客户端和支持 DLL。

  • 当新计算机连接到网络时,内置预启动执行环境 (PXE) 技术可用于下载网络启动程序。 有关启动计算机以安装Windows的 PXE 的详细信息,请参阅Windows部署服务更新分步指南
  • WINDOWS PE 2.0 的 RAMDISK 可启动映像可以存储在其中。WIM 格式并作为网络启动过程的一部分下载。 然后,可以直接从该媒体加载并运行 pe Windows PE。

使用 WDS 服务器打开会话

WDS 客户端必须打开与 WDS 服务器的会话。

  • 使用 WdsCliCreateSession 函数打开与 WDS 服务器的会话。 此函数采用服务器的名称或 IP 地址,并接收 WDS 客户端会话句柄的地址。
  • 如果打开与服务器的会话需要对 WDS 客户端进行身份验证,应用程序应在调用 WdsCliCreateSession 函数时提供包含客户端凭据的WDS_CLI_CRED结构的地址。 应用程序可以使用 WdsCliAuthorizeSession 函数将匿名会话转换为经过身份验证的会话。
  • 不再需要使用 WdsCliCreateSession 函数打开的会话时,应用程序应使用 WdsCliClose 函数关闭会话所持有的句柄和释放资源。

枚举 WDS 服务器上的系统映像

WDS 客户端可以使用 API 枚举 WDS 服务器上的系统映像。

获取有关图像的信息

WDS 客户端可以使用 API 获取有关 WDS 服务器上的映像的信息。 以下函数获取有关当前图像的信息。 由于 WdsCliFindFirstImageWdsCliFindNextImage 函数会更改当前图像句柄值,因此应用程序应存储它获取的任何信息,并且将来需要在调用 WdsCliFindFirstImageWdsCliFindNextImage 函数之前存储它获取的任何信息。

记录 WDS 客户端事件

WDS 客户端库的日志记录功能使安装进度事件能够从客户端发送到 WDS 服务器。

  • 使用 WdsCliInitializeLog 函数初始化 WDS 客户端会话的日志。
  • 使用 WdsCliLog 函数将事件消息写入 WDS 服务器日志。
  • 在 Windows Server 2008 上,WDS 服务器将客户端事件写入应用程序特定的事件日志,该事件日志可通过eventvwr.exe和调试跟踪日志查看。 在启用了调试日志记录的 Windows Server 2003 上,WDS 服务器会将客户端事件写入位于 %windir%\tracing\wdsserver.log 的日志文件。 必须在服务器上启用 WDS 客户端日志记录才能捕获这些事件。

关于Windows部署服务 API

使用 Windows 部署服务服务器 API