wdsutil add-device

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

Preconfigura un equipo en Active Directory Domain Services (AD DS). Los equipos preconfigurados también se denominan equipos conocidos. Esto le permite configurar propiedades 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 /add-Device /Device:<Devicename> /ID:<UUID | MAC address> [/ReferralServer:<Servername>] [/BootProgram:<Relativepath>] [/WdsClientUnattend:<Relativepath>] [/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:<Relativepath>] [/OU:<DN of OU>] [/Domain:<Domain>]

Parámetros

Parámetro Descripción
/Device:<Devicename> Especifica el nombre del dispositivo que se va a agregar.
/ID:<UUID|MAC address> Especifica el GUID/UUID o la dirección MAC del equipo. Un GUID/UUID debe tener uno de los dos formatos: cadena binaria (/ID:ACEFA3E81F20694E953EB2DAA1E8B1B6) o cadena GUID (/ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6). Una dirección MAC debe tener el siguiente formato: 00B056882FDC (sin guiones) o 00-B0-56-88-2F-DC (con guiones)
[/ReferralServer:<Servername>] 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:<Relativepath>] Especifica la ruta relativa desde la carpeta remoteInstall al programa de arranque en red que debería recibir este equipo. Por ejemplo: boot\x86\pxeboot.com
[/WdsClientUnattend:<Relativepath>] Especifica la ruta de acceso relativa de la carpeta remoteInstall al archivo de instalación desatendida que automatiza las pantallas de instalación del cliente de Servicios de implementación de Windows.
[/User:<Domain\User|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 al dominio como esta cuenta de equipo durante la instalación del sistema operativo. El valor predeterminado es Yes.
[/BootImagepath:<Relativepath>] Especifica la ruta de acceso relativa desde la carpeta remoteInstall a la imagen de arranque que debe usar este equipo.
[/OU:<DN of OU>] Nombre distintivo de la unidad organizativa donde se debe crear el objeto de cuenta de equipo. Por ejemplo: OU=MyOU,CN=Test, DC=Domain,DC=com. La ubicación predeterminada es el contenedor del equipo predeterminado.
[/Domain:<Domain>] El dominio donde se debe crear el objeto de cuenta de equipo. La ubicación predeterminada es el directorio local.

Ejemplos

Para agregar un equipo mediante una dirección MAC, escriba:

wdsutil /add-Device /Device:computer1 /ID:00-B0-56-88-2F-DC

Para agregar un equipo mediante una cadena GUID, escriba:

wdsutil /add-Device /Device:computer1 /ID:{E8A3EFAC-201F-4E69-953F-B2DAA1E8B1B6} /ReferralServer:WDSServer1 /BootProgram:boot\x86\pxeboot.com/WDSClientUnattend:WDSClientUnattend\unattend.xml /User:Domain\MyUser/JoinRights:Full /BootImagepath:boot\x86\images\boot.wim /OU:OU=MyOU,CN=Test,DC=Domain,DC=com