WDSUTIL Set-Server

2025-05-08
Aplica-se a: ✅ Windows Server 2025, ✅ Windows Server 2022, ✅ Windows Server 2019, ✅ Windows Server 2016, ✅ Windows 11, ✅ Windows 10, ✅ Azure Local 2311.2 and later

Define as configurações para um servidor dos Serviços de Implantação do Windows.

Sintaxe

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	Descrição
[/Server:<Nome do servidor>]	Especifica o nome do servidor. Pode ser o nome NetBIOS ou o nome de domínio totalmente qualificado (FQDN). Se nenhum nome de servidor for especificado, o servidor local será usado.
[/Autorizar:{Sim \| Não}]	Especifica se este servidor deve ser autorizado no protocolo DHCP (Dynamic Host Control Protocol).
[/RogueDetection:{Sim \| Não}]	Habilita ou desabilita a deteção de não autorizados DHCP.
[/AnswerClients:{Todos \| Conhecido \| Nenhum}]	Especifica quais clientes esse servidor responderá. Se você definir esse valor como Conhecido, um computador deverá ser pré-configurado nos Serviços de Domínio Ative Directory (AD DS) antes de ser respondido pelo servidor dos Serviços de Implantação do Windows.
[/Responsedelay:<tempo em segundos>]	A quantidade de tempo que o servidor aguardará antes de responder a um cliente de inicialização. Essa configuração não se aplica a computadores pré-configurados.
[/AllowN12forNewClients:{Sim \| Não}]	para o Windows Server 2008, especifica que os clientes desconhecidos não precisarão pressionar a tecla F12 para iniciar uma inicialização de rede. Os clientes conhecidos receberão o programa de inicialização especificado para o computador ou, se não for especificado, o programa de inicialização especificado para a arquitetura. para o Windows Server 2008 R2, esta opção foi substituída pelo seguinte comando: wdsutil /Set-Server /PxepromptPolicy /New:Noprompt
[/ArchitectureDiscovery:{Sim \| Não}]	Habilita ou desabilita a descoberta de arquitetura. Isso facilita a descoberta de clientes baseados em x64 que não transmitem sua arquitetura corretamente.
[/resetBootProgram:{Sim \| Não}]	Determina se o caminho de inicialização será apagado para um cliente que acabou de inicializar sem exigir pressionar uma tecla F12.
[/DefaultX86X64Imagetype: {x86 \| x64 \| Ambos}]	Controla quais imagens de inicialização serão mostradas para clientes baseados em x64.
[/UseDhcpPorts:{Sim \| Não}]	Especifica se o servidor PXE deve ou não tentar ligar à porta DHCP, porta TCP 67. Se o DHCP e os Serviços de Implantação do Windows estiverem em execução no mesmo computador, você deverá definir essa opção como Não para permitir que o servidor DHCP utilize a porta e definir o parâmetro /DhcpOption60 como Sim. A configuração padrão para esse valor é Sim.
[/DhcpOption60:{Sim \| Não}]	Especifica se a opção 60 do DHCP deve ser configurada para suporte a PXE. Se o DHCP e os Serviços de Implantação do Windows estiverem em execução no mesmo servidor, defina essa opção como Sim e defina a opção /UseDhcpPorts como Não. A configuração padrão para esse valor é Não.
[/RpcPort:<Número da> porta]	Especifica o número da porta TCP a ser usado para atender às solicitações do cliente.
[/PxepromptPolicy]	Configura como clientes conhecidos (pré-configurados) e novos iniciam uma inicialização PXE. Esta opção aplica-se apenas ao Windows Server 2008 R2. Você define as configurações usando as seguintes opções: - [/Conhecido:{OptIn\|OptOut\|Noprompt}] - Define a política para clientes pré-configurados. - [/Novo:{OptIn\|OptOut\|Noprompt}] - Define a política para novos clientes. OptIn significa que o cliente precisa pressionar uma tecla para inicializar PXE, caso contrário, ele voltará para o próximo dispositivo de inicialização. Noprompt significa que o cliente sempre será PXE Boot. OptOut significa que o cliente inicializará PXE, a menos que a tecla Esc seja pressionada.
[/BootProgram:<Caminho> relativo] /Architecture:{x86 \| ia64 \| x64}	Especifica o caminho relativo para o programa de inicialização na pasta remoteInstall (por exemplo, boot\x86\pxeboot.n12) e especifica a arquitetura do programa de inicialização.
[/N12BootProgram:<Caminho> relativo] /Architecture:{x86 \| ia64 \| x64}	Especifica o caminho relativo para o programa de inicialização que não requer pressionar a tecla F12 (por exemplo, boot\x86\pxeboot.n12) e especifica a arquitetura do programa de inicialização.
[/BootImage:<Caminho> relativo] /Architecture:{x86 \| ia64 \| x64}	Especifica o caminho relativo para a imagem de inicialização que os clientes de inicialização devem receber e especifica a arquitetura da imagem de inicialização. Você pode especificar isso para cada arquitetura.
[/PreferencialDC:<Nome> DC]	Especifica o nome do controlador de domínio que os Serviços de Implantação do Windows devem usar. Pode ser o nome NetBIOS ou o FQDN.
[/PreferencialGC:<Nome> GC]	Especifica o nome do servidor de catálogo global que os Serviços de Implantação do Windows devem usar. Pode ser o nome NetBIOS ou o FQDN.
[/PrestageUsingMAC:{Sim \| Não}]	Especifica se os Serviços de Implantação do Windows, ao criar contas de computador no AD DS, devem usar o endereço MAC em vez do GUID/UUID para identificar o computador.
[/NewMachineNamingPolicy:<Política>]	Especifica o formato a ser usado ao gerar nomes de computador para clientes. Para obter informações sobre o formato a ser usado para <a política>, clique com o botão direito do mouse no servidor no snap-in mmc, clique em Propriedades e exiba a guia Serviços de diretório . Por exemplo, /NewMachineNamingPolicy: %61Username%#.
[/NewMachineOU]	Usado para especificar o local no AD DS onde as contas de computador cliente serão criadas. Você especifica o local usando as seguintes opções. - [/type: Domínio do servidor \| Domínio de utilizador \| UserOU \| Personalizado ] Especifica o tipo de local. Serverdomain cria contas no mesmo domínio que o servidor dos Serviços de Implantação do Windows. Userdomain cria contas no mesmo domínio que o usuário que executa a instalação. UserOU cria contas na unidade organizacional do usuário que executa a instalação. Custom permite especificar um local personalizado (você também deve especificar um valor para /OU com esta opção). - [/OU:<Nome de domínio da UO]> - se você especificar Personalizado para a opção /type , esta opção especifica a unidade organizacional onde as contas de computador devem ser criadas.
[/DomainSearchOrder:{GCOnly \| DCFirst}]	Especifica a política para pesquisar contas de computador no AD DS (catálogo global ou controlador de domínio).
[/NewMachineDomainJoin:{Sim \| Não}]	Especifica se um computador que ainda não está pré-configurado no AD DS deve ou não ser associado ao domínio durante a instalação. A configuração padrão é Sim.
[/WdsClientLogging]	Especifica o nível de log para o servidor. - [/Ativado:{Sim \| No}] - Habilita ou desabilita o registro em log de ações do cliente dos Serviços de Implantação do Windows. - [/LoggingLevel: {Nenhum \| Erros \| Advertências \| Info} - Define o nível de registo. Nenhum é equivalente a desativar o registro. Erros é o nível mais baixo de registro em log e indica que apenas os erros serão registrados. Avisos inclui avisos e erros. Informações é o nível mais alto de registro em log e inclui erros, avisos e eventos informativos.
[/WdsUnattend]	Essas configurações controlam o comportamento de instalação autônoma do cliente dos Serviços de Implantação do Windows. Você define as configurações usando as seguintes opções: - [/Policy:{Ativado \| Disabled}] - Especifica se a instalação autônoma é usada ou não. - [/CommandlinePrecedence: {Sim \| No}] - Especifica se um arquivo de Autounattend.xml (se presente no cliente) ou um arquivo de instalação autônoma que foi passado diretamente para o cliente dos Serviços de Implantação do Windows com a opção /Unattend será usado em vez de um arquivo autônomo de imagem durante a instalação de um cliente. A predefinição é Não. - [/File:<Relative path> /Architecture:{x86 \| ia64 \| x64}] - Especifica o nome do arquivo, o caminho e a arquitetura do arquivo autônomo.
[/AutoaddPolicy]	Essas configurações controlam a política de adição automática. Você define as configurações usando as seguintes opções: - [/Política: {AdminApproval \| Disabled}] - AdminApprove faz com que todos os computadores desconhecidos sejam adicionados a uma fila pendente, onde o administrador pode então rever a lista de computadores e aprovar ou rejeitar cada solicitação, conforme apropriado. Desativado indica que nenhuma ação adicional é executada quando um computador desconhecido tenta inicializar no servidor. - [/PollInterval:{time in seconds}] - Especifica o intervalo (em segundos) no qual o programa de inicialização de rede deve sondar o servidor dos Serviços de Implantação do Windows. - [/MaxRetry: <Number>] - Especifica o número de vezes que o programa de inicialização de rede deve sondar o servidor dos Serviços de Implantação do Windows. Esse valor, juntamente com /PollInterval, dita quanto tempo o programa de inicialização de rede aguardará que um administrador aprove ou rejeite o computador antes do tempo limite. Por exemplo, um valor MaxRetry de 10 e um vlue PollInterval de 60 indicariam que o cliente deve sondar o servidor 10 vezes, aguardando 60 segundos entre as tentativas. Portanto, o cliente atingiria o tempo limite após 10 minutos (10 x 60 segundos = 10 minutos). - [/Message: <Message>] - Especifica a mensagem que é exibida para o cliente na página de diálogo do programa de inicialização de rede. - [/RetentionPeriod] - Especifica o número de dias que um computador pode estar em um estado pendente antes de ser automaticamente limpo. - [/Aprovado: <tempo em dias>] - Especifica o período de retenção para computadores aprovados. Você deve usar esse parâmetro com a opção /RetentionPeriod . - [/Outros: <tempo em dias>] - Especifica o período de retenção para computadores não aprovados (rejeitados ou pendentes). Você deve usar esse parâmetro com a opção /RetentionPeriod .
[/AutoaddSettings]	Especifica as configurações padrão a serem aplicadas a cada computador. Você define as configurações usando as seguintes opções: - /Architecture: {x86 \| ia64 \| x64} - Especifica a arquitetura. - [/BootProgram: <Caminho> relativo] - Especifica o programa de inicialização enviado para o computador aprovado. Se nenhum programa de inicialização for especificado, o padrão para a arquitetura do computador (conforme especificado no servidor) será usado. - [/WdsClientUnattend: <Caminho> relativo] - Define o caminho relativo para o arquivo autônomo que o cliente aprovado deve receber. - [/ReferralServer: <Nome> do servidor] - Especifica o servidor dos Serviços de Implantação do Windows que o cliente usará para baixar imagens. - [/BootImage: <Caminho> relativo] - Especifica a imagem de inicialização que o cliente aprovado receberá. - [/Usuário: <Domínio\Usuário \| User@Domain>] - Define permissões no objeto de conta de computador para dar ao usuário especificado os direitos necessários para ingressar o computador no domínio. - [JoinRights: {JoinOnly \| Completo}] - Especifica o tipo de direitos a serem atribuídos ao usuário. JoinOnly requer que o administrador redefina a conta do computador antes que o usuário possa ingressar o computador no domínio. Full dá acesso total ao usuário, incluindo o direito de juntar o computador ao domínio. - [/JoinDomain: {Sim \| No}] - Especifica se o computador deve ou não ser associado ao domínio como esta conta de computador durante uma instalação dos Serviços de Implantação do Windows. A configuração padrão é Sim.
[/BindPolicy]	Configura as interfaces de rede para o provedor PXE escutar. Você define a política usando as seguintes opções: - [/Política: {Incluir \| Exclude}] - Define a política de associação de interface para incluir ou excluir os endereços na lista de interfaces. - [/add] - adiciona uma interface à lista. Você também deve especificar /addresstype e /address. - [/remove] - remove uma interface da lista. Você também deve especificar /addresstype e /address. - /address:<IP ou MAC address> - Especifica o endereço IP ou MAC da interface a ser adicionada ou removida. - /addresstype: {IP \| MAC} - Indica o tipo de endereço especificado na opção /address .
[/RefreshPeriod: <segundos>]	Especifica com que frequência (em segundos) o servidor atualizará suas configurações.
[/BannedGuidPolicy]	Gerencia a lista de GUIDs proibidos usando as seguintes opções: - [/add] /Guid:<GUID> - adiciona o GUID especificado à lista de GUIDs proibidos. Qualquer cliente com este GUID será identificado pelo seu endereço MAC. - [/remove] /Guid:<GUID> - remove o GUID especificado da lista de GUIDs proibidos.
[/BcdRefreshPolicy]	Define as configurações para atualizar arquivos Bcd usando as seguintes opções: - [/Ativado:{Sim \| No}] - Especifica a política de atualização do Bcd. Quando /Enabled é definido como Sim, os arquivos Bcd são atualizados no intervalo de tempo especificado. - [/RefreshPeriod:<time in minutes>] - Especifica o intervalo de tempo no qual os arquivos Bcd são atualizados.
[/Transportes]	Configura as seguintes opções: [/ObtainIpv4De: {Dhcp \| Intervalo}] - Especifica a origem dos endereços IPv4. [/start: <starting Ipv4 address>] - Especifica o início do intervalo de endereços IP. Esta opção é necessária e válida somente se /ObtainIpv4From estiver definido como Range [/Fim: <Endereço Ipv4> final] - Especifica o final do intervalo de endereços IP. Esta opção é necessária e válida somente se /ObtainIpv4From estiver definido como Intervalo. [/ObtainIpv6De:Gama] [/start:<start IP address>] [/End:<End IP address>] Especifica a origem dos endereços IPv6. Esta opção aplica-se apenas ao Windows Server 2008 R2 e o único valor suportado é Range. [/startPort: <starting port>] - Especifica o início do intervalo de portas. [/EndPort: <Porta> final] - Especifica o fim do intervalo de portas. [/Perfil: {10Mbps \| 100Mbps \| 1Gbps \| Custom}] - Especifica o perfil de rede a ser usado. Esta opção só é suportada para servidores que executam o Windows Server 2008. [/MulticastSessionPolicy] Define as configurações de transferência para transmissões multicast. Este comando só está disponível para o Windows Server 2008 R2. [/Política:{Nenhum \| Desconexão Automática \| Multistream}] - Determina como lidar com clientes lentos. Nenhum significa manter todos os clientes em uma sessão na mesma velocidade. AutoDisconnect significa que todos os clientes que caírem abaixo do /Threshold especificado serão desconectados. Multistream significa que os clientes serão separados em várias sessões, conforme especificado por /StreamCount. [/Limiar:<Velocidade em KBps>] - para /Policy:AutoDisconnect, esta opção define a taxa de transferência mínima em KBps. Os clientes que caem abaixo desta taxa serão desconectados das transmissões multicast. [/StreamCount:{2 \| 3}] [/Fallback:{Sim \| No}] - para /Policy:Multistream, esta opção determina o número de sessões. 2 significa duas sessões (rápida e lenta) 3 significa três sessões (lenta, média, rápida). [/Fallback:{Sim \| No}] - Determina se os clientes que estão desconectados continuarão a transferência usando outro método (se suportado pelo cliente). Se você estiver usando o cliente WDS, o computador retornará para unicasting. Wdsmcast.exe não suporta um mecanismo de fallback. Esta opção também se aplica a clientes que não suportam Multistream. Nesse caso, o computador voltará para outro método em vez de passar para uma sessão de transferência mais lenta.

Exemplos

Para configurar o servidor para responder apenas clientes conhecidos, com um atraso de resposta de 4 minutos, digite:

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

Para definir o programa de inicialização e a arquitetura para o servidor, digite:

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

Para habilitar o registro em log no servidor, digite:

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

Para habilitar a autônoma no servidor, bem como a arquitetura e o arquivo autônomo do cliente, digite:

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

Para definir o servidor PXE (Pre-Boot execution Environment) para tentar ligar às portas TCP 67 e 60, digite:

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

Partilhar via

WDSUTIL Set-Server

Sintaxe

Parâmetros

Exemplos

Ligações relacionadas

Comentários

Recursos adicionais