wdsutil set-server

Artículo
04/06/2023

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

Configura los valores de un servidor de Servicios de implementación de Windows.

Sintaxis

wdsutil [Options] /Set-Server [/Server:<Server name>]
    [/Authorize:{Yes | No}]
    [/RogueDetection:{Yes | No}]
    [/AnswerClients:{All | Known | None}]
    [/Responsedelay:<time in seconds>]
    [/AllowN12forNewClients:{Yes | No}]
    [/ArchitectureDiscovery:{Yes | No}]
    [/resetBootProgram:{Yes | No}]
    [/DefaultX86X64Imagetype:{x86 | x64 | Both}]
    [/UseDhcpPorts:{Yes | No}]
    [/DhcpOption60:{Yes | No}]
    [/RpcPort:<Port number>]
    [/PxepromptPolicy
        [/Known:{OptIn | Noprompt | OptOut}]
        [/New:{OptIn | Noprompt | OptOut}]
    [/BootProgram:<Relative path>]
         /Architecture:{x86 | ia64 | x64}
    [/N12BootProgram:<Relative path>]
         /Architecture:{x86 | ia64 | x64}
    [/BootImage:<Relative path>]
         /Architecture:{x86 | ia64 | x64}
    [/PreferredDC:<DC Name>]
    [/PreferredGC:<GC Name>]
    [/PrestageUsingMAC:{Yes | No}]
    [/NewMachineNamingPolicy:<Policy>]
    [/NewMachineOU]
         [/type:{Serverdomain | Userdomain | UserOU | Custom}]
         [/OU:<Domain name of OU>]
    [/DomainSearchOrder:{GCOnly | DCFirst}]
    [/NewMachineDomainJoin:{Yes | No}]
    [/OSCMenuName:<Name>]
    [/WdsClientLogging]
         [/Enabled:{Yes | No}]
         [/LoggingLevel:{None | Errors | Warnings | Info}]
    [/WdsUnattend]
         [/Policy:{Enabled | Disabled}]
         [/CommandlinePrecedence:{Yes | No}]
         [/File:<path>]
             /Architecture:{x86 | ia64 | x64}
    [/AutoaddPolicy]
         [/Policy:{AdminApproval | Disabled}]
         [/PollInterval:{time in seconds}]
         [/MaxRetry:{Retries}]
         [/Message:<Message>]
         [/RetentionPeriod]
             [/Approved:<time in days>]
             [/Others:<time in days>]
    [/AutoaddSettings]
         /Architecture:{x86 | ia64 | x64}
         [/BootProgram:<Relative path>]
         [/ReferralServer:<Server name>
         [/WdsClientUnattend:<Relative path>]
         [/BootImage:<Relative path>]
         [/User:<Owner>]
         [/JoinRights:{JoinOnly | Full}]
         [/JoinDomain:{Yes | No}]
    [/BindPolicy]
         [/Policy:{Include | Exclude}]
         [/add]
              /address:<IP or MAC address>
              /addresstype:{IP | MAC}
         [/remove]
              /address:<IP or MAC address>
              /addresstype:{IP | MAC}
    [/RefreshPeriod:<time in seconds>]
    [/BannedGuidPolicy]
         [/add]
              /Guid:<GUID>
         [/remove]
             /Guid:<GUID>
    [/BcdRefreshPolicy]
         [/Enabled:{Yes | No}]
         [/RefreshPeriod:<time in minutes>]
    [/Transport]
         [/ObtainIpv4From:{Dhcp | Range}]
             [/start:<start IP address>]
             [/End:<End IP address>]
         [/ObtainIpv6From:Range]
             [/start:<start IP address>]
             [/End:<End IP address>]
         [/startPort:<start Port>
             [/EndPort:<start Port>
        [/Profile:{10Mbps | 100Mbps | 1Gbps | Custom}]
        [/MulticastSessionPolicy]
             [/Policy:{None | AutoDisconnect | Multistream}]
                 [/Threshold:<Speed in KBps>]
                 [/StreamCount:{2 | 3}]
                 [/Fallback:{Yes | No}]
        [/forceNative]

Parámetros

Parámetro	Descripción
[/Servidor:<Nombre del servidor>]	Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre de dominio completo (FQDN). Si no se especifica un nombre de servidor, se usará el servidor local.
[/Authorize:{Yes \| No}]	Especifica si se debe autorizar este servidor en el Protocolo de control dinámico de host (DHCP).
[/RogueDetection:{Yes \| No}]	Habilita o deshabilita la detección no autorizada de DHCP.
[/AnswerClients:{All \| Known \| None}]	Especifica qué clientes responderá este servidor. Si establece este valor en Known, un equipo debe estar preconfigurado en Active Directory Domain Services (AD DS) antes de que sea respondido por el servidor de Servicios de implementación de Windows.
[/Responsedelay:<tiempo en segundos>]	Cantidad de tiempo que el servidor esperará antes de responder a un cliente de arranque. Esta configuración no se aplica a equipos preconfigurados.
[/AllowN12forNewClients:{Yes \| No}]	para Windows Server 2008, especifica que los clientes desconocidos no tendrán que presionar la tecla F12 para iniciar un arranque de red. Los clientes conocidos recibirán el programa de arranque especificado para el equipo o, si no se especifica, el programa de arranque especificado para la arquitectura. para Windows Server 2008 R2, esta opción se ha reemplazado por el siguiente comando: wdsutil /Set-Server /PxepromptPolicy /New:Noprompt
[/ArchitectureDiscovery:{Yes \| No}]	Habilita o deshabilita la detección de arquitectura. Esto facilita la detección de clientes basados en x64 que no difunden correctamente su arquitectura.
[/resetBootProgram:{Yes \| No}]	Determina si la ruta de acceso de arranque se borrará para un cliente que acaba de arrancar sin necesidad de presionar una tecla F12.
[/DefaultX86X64Imagetype: {x86 \| x64 \| Both}]	Controla qué imágenes de arranque se mostrarán a los clientes basados en x64.
[/UseDhcpPorts:{Yes \| No}]	Especifica si el servidor del entorno de ejecución previo al arranque debe intentar enlazarse al puerto DHCP, puerto TCP 67. Si DHCP y los Servicios de implementación de Windows se están ejecutando en el mismo equipo, debería establecer esta opción en No para permitir que el servidor DHCP utilice el puerto, y establecer el parámetro /DhcpOption60 en Yes. La configuración predeterminada para este valor es Yes.
[/DhcpOption60:{Yes \| No}]	Especifica si la opción DHCP 60 debe configurarse para la compatibilidad con el entorno de ejecución previo al arranque. Si DHCP y los Servicios de implementación de Windows se ejecutan en el mismo servidor, establezca esta opción en Yes y la opción /UseDhcpPorts en No. La configuración predeterminada para este valor es No.
[/RpcPort:<Número de puerto>]	Especifica el número de puerto TCP que se usará para atender las solicitudes de cliente.
[/PxepromptPolicy]	Configura el modo en que los clientes nuevos y conocidos (preconfigurados) inician un arranque del entorno de ejecución previo al arranque. Esta opción solo se aplica a Windows Server 2008 R2. La configuración se establece con las siguientes opciones: - [/Known:{OptIn\| OptOut\| Noprompt}]: establece la directiva para los clientes preconfigurados. - [/New:{OptIn\| OptOut\| Noprompt}]: establece la directiva para los nuevos clientes. OptIn significa que el cliente debe presionar una tecla para arrancar el entorno de ejecución previo al arranque ; de lo contrario, volverá al siguiente dispositivo de arranque. Noprompt significa que el cliente siempre arrancará el entorno de ejecución previo al arranque. OptOut significa que el cliente arrancará el entorno de ejecución previo al arranque a menos que se presione la tecla Esc.
[/BootProgram:<Ruta de acceso relativa>] /Architecture:{x86 \| ia64 \| x64}	Especifica la ruta de acceso relativa al programa de arranque en la carpeta remoteInstall (por ejemplo, boot\x86\pxeboot.n12) y especifica la arquitectura del programa de arranque.
[/N12BootProgram:<Ruta de acceso relativa>] /Architecture:{x86 \| ia64 \| x64}	Especifica la ruta de acceso relativa al programa de arranque que no requiere pulsar la tecla F12 (por ejemplo, boot\x86\pxeboot.n12), y especifica la arquitectura del programa de arranque.
[/BootImage:<Ruta de acceso relativa>] /Architecture:{x86 \| ia64 \| x64}	Especifica la ruta de acceso relativa a la imagen de arranque que deben recibir los clientes de arranque y especifica la arquitectura de la imagen de arranque. Puede especificar esto para cada arquitectura.
[/PreferredDC:<Nombre del controlador de dominio>]	Especifica el nombre del controlador de dominio que deben usar los Servicios de implementación de Windows. Éste puede ser el nombre NetBIOS o el FQDN.
[/PreferredGC:<Nombre de GC>]	Especifica el nombre del servidor de catálogo global que deben usar los Servicios de implementación de Windows. Éste puede ser el nombre NetBIOS o el FQDN.
[/PrestageUsingMAC:{Yes \| No}]	Especifica si los Servicios de implementación de Windows, al crear cuentas de equipo en AD DS, deben usar la dirección MAC en lugar del GUID/UUID para identificar el equipo.
[/NewMachineNamingPolicy:<Directiva>]	Especifica el formato que se va a usar al generar nombres de equipo para los clientes. Para obtener información sobre el formato que se va a usar para la <directiva>, haga clic con el botón derecho en el servidor en el complemento mmc, haga clic en Propiedades y vea la pestaña Servicios de directorio. Por ejemplo, /NewMachineNamingPolicy: %61Username%#.
[/NewMachineOU]	Se usa para especificar la ubicación en AD DS donde se crearán las cuentas de equipo cliente. Especifique la ubicación usando las siguientes opciones. - [/type: Serverdomain \| Userdomain \| UserOU \| Custom ] Especifica el tipo de ubicación. Serverdomain crea cuentas en el mismo dominio que el servidor de Servicios de implementación de Windows. Userdomain crea cuentas en el mismo dominio que el usuario que realiza la instalación. UserOU crea cuentas en la unidad organizativa del usuario que realiza la instalación. Custom le permite especificar una ubicación personalizada (también debe especificar un valor para /OU con esta opción). - [/OU:<Nombre de dominio de OU>]: si especifica Custom para la opción /type, esta opción especifica la unidad organizativa donde se deben crear las cuentas de equipo.
[/DomainSearchOrder:{GCOnly \| DCFirst}]	Especifica la directiva para buscar cuentas de equipo en AD DS (catálogo global o controlador de dominio).
[/NewMachineDomainJoin:{Yes \| No}]	Especifica si un equipo que aún no está preconfigurado en AD DS debe unirse al dominio durante la instalación. El valor predeterminado es Sí.
[/WdsClientLogging]	Especifica el nivel de registro del servidor. - [/Enabled:{Yes\| No}] : habilita o deshabilita el registro de acciones de cliente de Servicios de implementación de Windows. - [/LoggingLevel: {None \| Errors \| Warnings \| Info}: establece el nivel de registro. None equivale a deshabilitar el registro. Errors es el nivel más bajo de registro e indican que solo se registrarán los errores. Warnings incluye advertencias y errores. Info es el nivel más alto de registro e incluye errores, advertencias y eventos informativos.
[/WdsUnattend]	Estas configuraciones controlan el comportamiento de la instalación desatendida del cliente de Servicios de implementación de Windows. La configuración se establece con las siguientes opciones: - [/Policy:{Enabled \| Disabled}]: especifica si se usa o no la instalación desatendida. - [/CommandlinePrecedence: {Yes \| No}]: especifica si un archivo Autounattend.xml (si está presente en el cliente) o un archivo de instalación desatendido que se pasó directamente al cliente de Servicios de implementación de Windows con la opción /Unattend se usará en lugar de un archivo desatendido de imagen durante una instalación de cliente. El valor predeterminado es No. - [/Archivo:<Ruta de acceso> /Architecture:{x86 \| ia64 \| x64}]: especifica el nombre de archivo, la ruta de acceso y la arquitectura del archivo desatendido.
[/AutoaddPolicy]	Esta configuración controla la directiva Agregar automáticamente. Puede establecer la configuración usando las siguientes opciones: - [/Policy: {AdminApproval \| Disabled}] - AdminApprove hace que todos los equipos desconocidos se agreguen a una cola pendiente, donde el administrador puede revisar la lista de equipos y aprobar o rechazar cada solicitud, según corresponda. Disabled indica que no se realiza ninguna acción adicional cuando un equipo desconocido intenta arrancar en el servidor. - /PollInterval:{tiempo en segundos}]: especifica el intervalo (en segundos) en el que el programa de arranque en red debe sondear el servidor de Servicios de implementación de Windows. - /MaxRetry: <Número>]: especifica el número de veces que el programa de arranque en red debe sondear el servidor de Servicios de implementación de Windows. Este valor, junto con /PollInterval, dicta cuánto tiempo esperará el programa de arranque de la red a que un administrador apruebe o rechace el equipo antes de que se agote el tiempo de espera. Por ejemplo, un valor MaxRetry de 10 y un valor PollInterval de 60 indicaría que el cliente debería sondear el servidor 10 veces, esperando 60 segundos entre intentos. Por lo tanto, el cliente agotaría el tiempo de espera después de 10 minutos (10 x 60 segundos = 10 minutos). - [/Message: <Mensaje>]: especifica el mensaje que se muestra al cliente en la página de diálogo del programa de arranque en red. - [/RetentionPeriod]: especifica el número de días que un equipo puede estar en un estado pendiente antes de purgarse automáticamente. - [/Approved: <tiempo en días>]: especifica el período de retención para los equipos aprobados. Debe usar este parámetro con la opción /RetentionPeriod. - [/Others: <tiempo en días>]: especifica el período de retención para equipos no aprobados (rechazados o pendientes). Debe usar este parámetro con la opción /RetentionPeriod.
[/AutoaddSettings]	Especifica la configuración predeterminada que se aplicará a cada equipo. Puede establecer la configuración usando las siguientes opciones: - /Architecture: {x86 \| ia64 \| x64}: especifica la arquitectura. - [/BootProgram: <Ruta de acceso relativa>]: especifica el programa de arranque enviado al equipo aprobado. Si no se especifica ningún programa de arranque, se usará el valor predeterminado para la arquitectura del equipo (como se especifica en el servidor). - [/WdsClientUnattend: <Ruta de acceso relativa>]: establece la ruta de acceso relativa al archivo desatendido que debe recibir el cliente aprobado. - [/ReferralServer: <Nombre del servidor>]: especifica el servidor de Servicios de implementación de Windows que el cliente usará para descargar imágenes. - [/BootImage: <Ruta de acceso relativa>]: especifica la imagen de arranque que recibirá el cliente aprobado. - [/Usuario: <Dominio\Usuario \| >Usuario@Dominio]: 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 Sí.
[/BindPolicy]	Configura las interfaces de red para que el proveedor del entorno de ejecución previo al arranque escuche. Defina la directiva usando las siguientes opciones: - [/Policy: {Include \| Exclude}]: establece la directiva de enlace de interfaz para incluir o excluir las direcciones de la lista de interfaz. - [/add]: agrega una interfaz a la lista. También debe especificar /addresstype y /address. - [/remove]: quita una interfaz de la lista. También debe especificar /addresstype y /address. - /address: <Dirección IP o MAC>: especifica la dirección IP o MAC de la interfaz que se va a agregar o quitar. - /addresstype: {IP \| MAC}: indica el tipo de dirección especificado en la opción /address.
[/RefreshPeriod: <segundos>]	Especifica con qué frecuencia (en segundos) el servidor actualizará su configuración.
[/BannedGuidPolicy]	Administra la lista de GUID prohibidos mediante las siguientes opciones: - [/add] /Guid:<GUID>: agrega el GUID especificado a la lista de GUID prohibidos. En su lugar, cualquier cliente con este GUID se identificará mediante su dirección MAC. - [/remove] /Guid:<GUID>: quita el GUID especificado de la lista de GUID prohibidos.
[/BcdRefreshPolicy]	Establece la configuración para la actualización de los archivos Bcd usando las siguientes opciones: - [/Enabled:{Yes \| No}] : especifica la directiva de actualización de Bcd. Cuando /Enabled se establece en Yes, los archivos Bcd se actualizan en el intervalo de tiempo especificado. - [/RefreshPeriod:<time en minutos>]: especifica el intervalo de tiempo en el que se actualizan los archivos Bcd.
[/Transport]	Configure las siguientes opciones: [/ObtainIpv4From: {Dhcp \| Range}]: especifica el origen de las direcciones IPv4. [/start: <Dirección Ipv4 inicial>]: especifica el inicio del intervalo de direcciones IP. Esta opción es necesaria y válida solo si /ObtainIpv4From está establecido en Range [/End: <Dirección Ipv4 final>: especifica el final del intervalo de direcciones IP. Esta opción es necesaria y válida solo si /ObtainIpv4From está establecido en Range. [/ObtainIpv6From:Range] [/start:<Dirección IP inicial>] [/End:<Dirección IP final>] especifica el origen de las direcciones IPv6. Esta opción solo se aplica a Windows Server 2008 R2 y el único valor admitido es Range. [/startPort: <puerto inicial>]: especifica el inicio del intervalo de puertos. [/EndPort: <puerto final>]: especifica el final del intervalo de puertos. [/Profile: {10 Mbps \| 100 Mbps \| 1Gbps \| Custom}]: especifica el perfil de red que se va a usar. Esta opción solo se admite para servidores que ejecutan Windows Server 2008. [/MulticastSessionPolicy] Configura los valores de transferencia para las transmisiones de multidifusión. Este comando solo está disponible para Windows Server 2008 R2. [/Policy:{None \| AutoDisconnect \| Multistream}] : determina cómo controlar clientes lentos. None significa mantener todos los clientes en una sesión a la misma velocidad. AutoDisconnect significa que todos los clientes que bajen por debajo del umbral especificado se desconectarán. Multistream significa que los clientes se separarán en varias sesiones, según lo especificado por /StreamCount. [/Threshold:<Velocidad en KBps>: para /Policy:AutoDisconnect, esta opción establece la velocidad de transferencia mínima en KBps. Los clientes que bajen por debajo de esta velocidad se desconectarán de las transmisiones de multidifusión. [/StreamCount:{2 \| 3}] [/Fallback:{Yes \| No}] : para /Policy:Multistream, esta opción determina el número de sesiones. 2 significa dos sesiones (rápida y lenta) 3 significa tres sesiones (lenta, media, rápida). [/Fallback:{Yes \| No}]: determina si los clientes que están desconectados continuarán la transferencia mediante otro método (si es compatible con el cliente). Si usa el cliente WDS, el equipo volverá a la unidifusión. Wdsmcast.exe no admite un mecanismo de reserva. Esta opción también se aplica a los clientes que no admiten Multistream. En ese caso, el equipo recurrirá a otro método en lugar de pasar a una sesión de transferencia más lenta.

Ejemplos

Para establecer que el servidor responda solo a los clientes conocidos, con un retraso de respuesta de 4 minutos, escriba:

wdsutil /Set-Server /AnswerClients:Known /Responsedelay:4

Para establecer el programa de arranque y la arquitectura del servidor, escriba:

wdsutil /Set-Server /BootProgram:boot\x86\pxeboot.n12 /Architecture:x86

Para habilitar el registro en el servidor, escriba:

wdsutil /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings

Para activar el modo desatendido en el servidor, así como la arquitectura y el archivo de desatendido del cliente, escriba:

wdsutil /Set-Server /WdsUnattend /Policy:Enabled /File:WDSClientUnattend \unattend.xml /Architecture:x86

Para establecer que el servidor de ejecución previa al arranque (PXE) intente enlazar con los puertos TCP 67 y 60, escriba:

wdsutil /Set-server /UseDhcpPorts:No /DhcpOption60:Yes

wdsutil set-server

Sintaxis

Parámetros

Ejemplos

Vínculos relacionados

Recursos adicionales