wdsutil set-device

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.

Cambia los atributos de un equipo preconfigurado. Un equipo preconfigurado es un equipo que se ha vinculado a un objeto de cuenta de equipo en Active Directory Domain Services (AD DS). Los clientes preconfigurados también se denominan equipos conocidos. Puede configurar propiedades en la cuenta de equipo para controlar la instalación del cliente. Por ejemplo, puede configurar el programa de arranque de red y el archivo de instalación desatendida que el cliente debería recibir, así como el servidor del que el cliente debería descargar los archivos de arranque.

Sintaxis

wdsutil [Options] /Set-Device /Device:<Device name> [/ID:<UUID | MAC address>] [/ReferralServer:<Server name>] [/BootProgram:<Relative path>]
[/WdsClientUnattend:<Relative path>] [/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:<Relative path>] [/Domain:<Domain>] [/resetAccount]

Parámetros

Parámetro Descripción
/Device:<nombre del equipo> Especifica el nombre del equipo (SAM-Account-Name).
[/ID:<UUID | MAC address>] Especifica el GUID/UUID o la dirección MAC del equipo. Este valor debe tener uno de los tres formatos siguientes:

- Cadena binaria: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Cadena GUID/UUID: /ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6
- Dirección MAC: 00B056882FDC (sin guiones) o 00-B0-56-88-2F-DC (con guiones)

[/ReferralServer:<Nombre del servidor>] Especifica el nombre del servidor con el que se debe poner en contacto para descargar el programa de arranque de red y la imagen de arranque mediante Trivial File Transfer Protocol (tftp).
[/BootProgram:< Ruta de acceso relativa>] Especifica la ruta de acceso relativa de la carpeta remoteInstall al programa de arranque de red que recibirá el equipo especificado. Por ejemplo: boot\x86\pxeboot.com
[/WdsClientUnattend:<Ruta de acceso relativa>] Especifica la ruta de acceso relativa de la carpeta remoteInstall al archivo desatendido que automatiza las pantallas de instalación para el cliente de Servicios de implementación de Windows.
[/Usuario:< Dominio\Usuario | >User@Domain] Establece permisos en el objeto de cuenta de equipo para conceder al usuario especificado los derechos necesarios para unir el equipo al dominio.
[/JoinRights:{JoinOnly | Full}] Especifica el tipo de derechos que se asignarán al usuario.

- JoinOnly requiere que el administrador restablezca la cuenta del equipo antes de que el usuario pueda unir el equipo al dominio.
- Full proporciona acceso total al usuario, incluido el derecho de unir el equipo al dominio.

[/JoinDomain:{Yes | No}] Especifica si el equipo debe unirse o no al dominio como esta cuenta de equipo durante una instalación de Servicios de implementación de Windows. El valor predeterminado es .
[/BootImagepath:< Ruta de acceso relativa>] Especifica la ruta de acceso relativa desde la carpeta remoteInstall a la imagen de arranque que usará este equipo.
[/Domain:<Dominio>] Especifica el dominio que se va a buscar en el equipo preconfigurado. El valor predeterminado es el nombre del dominio local.
[/resetAccount] Restablece los permisos en el equipo especificado para que cualquier persona con los permisos adecuados pueda unirse al dominio mediante esta cuenta.

Ejemplos

Para establecer el programa de arranque de red y el servidor de referencia para un equipo, escriba:

wdsutil /Set-Device /Device:computer1 /ReferralServer:MyWDSServer
/BootProgram:boot\x86\pxeboot.n12

Para establecer varias opciones de configuración para un equipo, escriba:

wdsutil /verbose /Set-Device /Device:computer2 /ID:00-B0-56-88-2F-DC /WdsClientUnattend:WDSClientUnattend\unattend.xml
/User:Domain\user /JoinRights:JoinOnly /JoinDomain:No /BootImagepath:boot\x86\images\boot.wim /Domain:NorthAmerica /resetAccount