使用 Windows 部署服務用戶端 API
在標準 Windows 部署服務 (WDS) 解決方案無法用來安裝 Windows 的環境中，WDS 用戶端的 API 可讓開發人員撰寫自訂部署應用程式。 應用程式可以使用此 API 與 WDS 伺服器通訊，以取得伺服器可用的系統映射相關資訊。 自訂 WDS 用戶端應用程式應遵循下列指導方針。
在伺服器上安裝 WDS 角色
- Windows Deployment Services (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 自動化安裝套件 (「傳統型安裝套件」) 安裝 WDS 伺服器角色。
啟動 Windows PE 2.0
如果尚未啟動，則必須啟動 Windows PE 2.0。 只有當 WDS 用戶端和支援 DLL 位於 Microsoft Windows 預先安裝環境 (Windows PE 2.0) 階段時，才會 setup.exe載入它。
- 當新電腦連線到網路時，內建的開機前執行環境 (PXE) 技術可用來下載網路開機程式。 如需將電腦開機以安裝 Windows 的詳細資訊，請參閱 Windows 部署服務更新逐步指南。
- Windows PE 2.0 的 RAMDISK 可開機映射可以儲存在 中。WIM 格式並下載為網路開機程式的一部分。 然後可以直接從該媒體載入並執行 Windows PE。
使用 WDS 伺服器開啟會話
WDS 用戶端必須使用 WDS 伺服器開啟會話。
- 使用 WdsCliCreateSession 函式 來開啟與 WDS 伺服器的會話。 此函式會接受伺服器的名稱或 IP 位址，並接收 WDS 用戶端會話控制碼的位址。
- 如果以伺服器開啟會話需要驗證 WDS 用戶端，應用程式應該在呼叫WdsCliCreateSession函式時，提供包含用戶端認證的WDS_CLI_CRED結構位址。 應用程式可以使用 WdsCliAuthorizeSession 函式，將匿名會話轉換成已驗證的會話。
- 當不再需要使用 WdsCliCreateSession 函式開啟的會話時，應用程式應該使用 WdsCliClose 函式來關閉會話所持有的控制碼和釋放資源。
列舉 WDS 伺服器上的系統映射
WDS 用戶端可以使用 API 列舉 WDS 伺服器上的系統映射。
- 使用 WdsCliFindFirstImage 函式來取得第一個映射的控制碼，以及初始化 WDS 伺服器上的映射列舉。
- 使用 WdsCliFindNextImage 函式來遞增 WdsCliFindFirstImage 函式所啟動的列舉。 WdsCliFindNextImage函式會取得下一個影像的控制碼。
- 使用 WdsCliGetImageIndex 函式來取得目前影像的影像索引。 只有在再次使用 WdsCliFindNextImage 或 WdsCliClose 函式之前，這個值才有效。
- 使用 WdsCliGetEnumerationFlags 函式來取得影像篩選的相關資訊旗標。
取得影像的相關資訊
WDS 用戶端可以使用 API 來取得 WDS 伺服器上映射的相關資訊。 下列函式會取得目前映射的相關資訊。 因為 WdsCliFindFirstImage 和 WdsCliFindNextImage 函式會變更目前的影像控制碼值，所以應用程式應該儲存它取得的任何資訊，而且未來在呼叫 WdsCliFindFirstImage 或 WdsCliFindNextImage 函式之前，應該儲存它所取得的任何資訊。
- 使用 WdsCliGetImageArchitecture 函式來取得目前映射的處理器架構。
- 使用 WdsCliGetImagePath 函式，取得包含目前影像之影像檔案的相對路徑。
- 使用 WdsCliGetImageSize 函式來取得影像大小。
- 使用 WdsCliGetImageVersion 函式來取得映射版本。
- 使用 WdsCliGetImageLanguage 函式來取得目前影像的預設語言。
- 使用 WdsCliGetImageLanguages 函式來取得目前影像支援的語言陣列。
- 使用 WdsCliGetImageLastModifiedTime 會傳回目前影像的上次修改時間。
- 使用 WdsCliGetImageName 函式來取得目前影像的名稱。
- 使用 WdsCliGetImageDescription 函式來取得目前影像的描述。
- 使用 WdsCliGetImageGroup 函式來取得目前映射的映射組名。
- 使用 WdsCliGetImageHalName 函式取得目前影像的硬體抽象層 (HAL) 名稱。
記錄 WDS 用戶端事件
WDS 用戶端程式庫的記錄功能可讓安裝進度事件從用戶端傳送至 WDS 伺服器。
- 使用 WdsCliInitializeLog 函式，初始化 WDS 用戶端會話的記錄。
- 使用 WdsCliLog 函式，將事件訊息寫入 WDS 伺服器記錄檔。
- 在 Windows Server 2008 上，WDS 伺服器會將用戶端事件寫入至可透過eventvwr.exe和偵錯追蹤記錄檔檢視的應用程式特定事件記錄檔。 在已啟用偵錯記錄的 Windows Server 2003 上，WDS 伺服器會將用戶端事件寫入位於 %windir%\tracing\wdsserver.log 的記錄檔。 必須在伺服器上啟用 WDS 用戶端記錄，才能擷取這些事件。
相關主題