Uso dell'API client di Servizi di distribuzione Windows
Negli ambienti in cui non è possibile usare una soluzione WDS (Windows Deployment Services) standard per installare Windows, l'API del client WDS consente agli sviluppatori di scrivere applicazioni di distribuzione personalizzate. Le applicazioni possono usare questa API per comunicare con il server WDS per ottenere informazioni sulle immagini di sistema disponibili dal server. Le applicazioni client WDS personalizzate devono rispettare le linee guida seguenti.
Installare il ruolo WDS nel server
- Servizi di distribuzione Windows (WDS) è la versione modificata di Servizi di installazione remota (RIS), sarà necessario il ruolo del server WDS nel server per implementare soluzioni client WDS personalizzate.
- WDS sostituisce RIS come componente standard a partire da Windows Server 2008 e Windows Server 2003 con Service Pack 2 (SP2).
- È necessario aggiornare il server RIS a WDS in Windows Server 2003 con Service Pack 1 (SP1). È possibile installare il ruolo del server WDS con Windows Automated Installation Kit (WAIK).
Avviare Windows PE 2.0
Windows PE 2.0 deve essere avviato, se non è già stato avviato. Il client WDS e le DLL di supporto vengono caricati solo dalla setup.exe quando si trova nella fase di elaborazione dell'elaborazione dell'installazione di Microsoft Windows Preinstallation Environment (Windows PE 2.0).
- Quando un nuovo computer è connesso alla rete, è possibile usare la tecnologia PXE (Preboot Execution Environment) predefinita per scaricare il programma di avvio di rete. Per altre informazioni sull'avvio PXE di un computer per installare Windows, vedere Guida dettagliata all'aggiornamento di Servizi di distribuzione Windows.
- Un'immagine di avvio RAMDISK di Windows PE 2.0 può essere archiviata in . Formato WIM e scaricato come parte del processo di avvio di rete. Windows PE può quindi essere caricato ed eseguito direttamente da tale supporto.
Aprire una sessione con il server WDS
Il client WDS deve aprire una sessione con un server WDS.
- Usare la funzione WdsCliCreateSession per aprire una sessione con un server WDS. Questa funzione accetta il nome o l'indirizzo IP del server e riceve l'indirizzo dell'handle per la sessione client WDS.
- Se si apre la sessione con il server sarà necessario autenticare il client WDS, l'applicazione deve fornire l'indirizzo di una struttura WDS_CLI_CRED contenente le credenziali client quando si chiama la funzione WdsCliCreateSession . L'applicazione può usare la funzione WdsCliAuthorizeSession per convertire una sessione anonima in una sessione autenticata.
- Quando la sessione aperta con la funzione WdsCliCreateSession non è più necessaria, l'applicazione deve usare la funzione WdsCliClose per chiudere l'handle e rilasciare le risorse mantenute dalla sessione.
Enumerare le immagini di sistema nel server WDS
Il client WDS può usare l'API per enumerare le immagini di sistema nel server WDS.
- Usare la funzione WdsCliFindFirstImage per ottenere un handle per la prima immagine e inizializzare l'enumerazione delle immagini nel server WDS.
- Usare la funzione WdsCliFindNextImage per incrementare l'enumerazione avviata dalla funzione WdsCliFindFirstImage . La funzione WdsCliFindNextImage ottiene l'handle per l'immagine successiva.
- Usare la funzione WdsCliGetImageIndex per ottenere l'indice dell'immagine per l'immagine corrente. Questo valore è valido solo finché le funzioni WdsCliFindNextImage o WdsCliClose vengono usate di nuovo.
- Usare la funzione WdsCliGetEnumerationFlags per ottenere flag informativi sul filtro delle immagini.
Ottenere informazioni sulle immagini
Il client WDS può usare l'API per ottenere informazioni sulle immagini in un server WDS. Le funzioni seguenti ottengono informazioni sull'immagine corrente. Poiché le funzioni WdsCliFindFirstImage e WdsCliFindNextImage modificano il valore dell'handle immagine corrente, l'applicazione deve archiviare tutte le informazioni che ottiene e sarà necessario in futuro prima di chiamare nuovamente le funzioni WdsCliFindFirstImage o WdsCliFindNextImage .
- Usare la funzione WdsCliGetImageArchitecture per ottenere l'architettura del processore dell'immagine corrente.
- Usare la funzione WdsCliGetImagePath per ottenere il percorso relativo del file di immagine che contiene l'immagine corrente.
- Usare la funzione WdsCliGetImageSize per ottenere le dimensioni dell'immagine.
- Usare la funzione WdsCliGetImageVersion per ottenere la versione dell'immagine.
- Usare la funzione WdsCliGetImageLanguage per ottenere la lingua predefinita dell'immagine corrente.
- Usare la funzione WdsCliGetImageLanguages per ottenere una matrice di lingue supportate dall'immagine corrente.
- Usare WdsCliGetImageLastModifiedTime restituisce l'ora dell'ultima modifica per l'immagine corrente.
- Usare la funzione WdsCliGetImageName per ottenere il nome dell'immagine corrente.
- Usare la funzione WdsCliGetImageDescription per ottenere la descrizione dell'immagine corrente.
- Usare la funzione WdsCliGetImageGroup per ottenere il nome del gruppo di immagini per l'immagine corrente.
- Usare la funzione WdsCliGetImageHalName per ottenere il nome Hardware Abstraction Layer (HAL) per l'immagine corrente.
Registrare gli eventi client WDS
La funzionalità di registrazione della libreria client WDS consente di inviare eventi di stato di installazione dal client al server WDS.
- Usare la funzione WdsCliInitializeLog per inizializzare il log per la sessione client WDS.
- Usare la funzione WdsCliLog per scrivere messaggi di evento nel log del server WDS.
- In Windows Server 2008 il server WDS scrive gli eventi client in un registro eventi specifico dell'applicazione visualizzabile tramite eventvwr.exe e il log di traccia di debug. In Windows Server 2003 con la registrazione di debug abilitata, il server WDS scriverà eventi client nel file di log disponibile in %windir%\tracing\wdsserver.log. La registrazione client WDS deve essere abilitata nel server per acquisire questi eventi.
Argomenti correlati