wdsutil set-server
Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012
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:<Server name>] | Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de domínio totalmente qualificado). Se um nome do servidor não for especificado, o servidor local será usado. |
| [/Authorize:{Yes | No}] | Especifica se esse servidor deve ser autorizado no DHCP (Dynamic Host Control Protocol). |
| [/RogueDetection:{Yes | No}] | Habilita ou desabilita a detecção de invasor DHCP. |
| [/AnswerClients:{All | Known | None}] | Especifica quais clientes esse servidor atenderá. Se você definir esse valor como Conhecido, um computador deverá estar em pré-teste no AD DS (Active Directory Domain Services) antes que ele seja respondido pelo servidor dos Serviços de Implantação do Windows. |
| [/Responsedelay:<time in seconds>] | 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 em pré-teste. |
| [/AllowN12forNewClients:{Yes | No}] | para o Windows Server 2008, especifica que 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, essa opção foi substituída pelo seguinte comando: wdsutil /Set-Server /PxepromptPolicy /New:Noprompt |
| [/ArchitectureDiscovery:{Yes | No}] | Habilita ou desabilita a descoberta de arquitetura. Isso facilita a descoberta de clientes baseados em x64 que não transmitem corretamente sua arquitetura. |
| [/resetBootProgram:{Yes | No}] | Determina se o caminho de inicialização será apagado para um cliente que acabou de ser inicializado sem precisar pressionar a tecla F12. |
| [/DefaultX86X64Imagetype: {x86 | x64 | Both}] | Controla quais imagens de inicialização serão mostradas para clientes baseados em x64. |
| [/UseDhcpPorts:{Yes | No}] | Especifica se o servidor PXE deve ou não tentar associar à porta DHCP, porta TCP 67. Se os Serviços de Implantação do Windows e DHCP estiverem em execução no mesmo computador, você deverá definir essa opção como Não para habilitar o servidor DHCP a utilizar a porta e definir o parâmetro /DhcpOption60 como Sim. A configuração padrão para esse valor é Sim. |
| [/DhcpOption60:{Yes | No}] | Especifica se a opção DHCP 60 deve ser configurada para suporte a PXE. Se os Serviços de Implantação do Windows e DHCP 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:<Port number>] | Especifica o número da porta TCP a ser usado para atender às solicitações do cliente. |
| [/PxepromptPolicy] | Configura o quão conhecidos (pré-teste) e novos clientes iniciam uma inicialização PXE. Essa opção se aplica apenas ao Windows Server 2008 R2. Defina as configurações usando as seguintes opções: - [/Known:{OptIn|OptOut|Noprompt}] - Define a política para clientes em pré-teste. OptIn significa que o cliente precisa pressionar uma tecla para Inicialização PXE, caso contrário, ele retornará para o próximo dispositivo de inicialização. Noprompt significa que o cliente sempre será fará Inicialização PXE. OptOut significa que o cliente fará Inicialização PXE, a menos que a tecla Esc seja pressionada. |
| [/BootProgram:<Relative path>] /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:<Relative path>] /Architecture:{x86 | ia64 | x64} | Especifica o caminho relativo para o programa de inicialização que não requer que a tecla F12 seja pressionada (por exemplo, boot\F12\pxeboot.x86) e especifica a arquitetura do programa de inicialização. |
| [/BootImage:<Relative path>] /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. Isso pode ser especificado para cada arquitetura. |
| [/PreferredDC:<DC Name>] | 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 FQDN. |
| [/PreferredGC:<GC Name>] | 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 FQDN. |
| [/PrestageUsingMAC:{Yes | No}] | 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:<Policy>] | 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 veja a guia Serviços de diretório. Por exemplo, /NewMachineNamingPolicy: %61Username%#. |
| [/NewMachineOU] | Usado para especificar o local no AD DS em que as contas de computador cliente serão criadas. Especifique o local usando as opções a seguir. - [/type: Serverdomain | Userdomain | UserOU | Custom ] 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. Personalizado permite que você especifique um local personalizado (você também deve especificar um valor para /UO com essa opção). |
| [/DomainSearchOrder:{GCOnly | DCFirst}] | Especifica a política para pesquisa de contas de computador no AD DS (catálogo global ou controlador de domínio). |
| [/NewMachineDomainJoin:{Yes | No}] | Especifica se um computador que ainda não esteja em pré-teste no AD DS deve ser ingressado no domínio durante a instalação. A configuração padrão é Sim. |
| [/WdsClientLogging] | Especifica o nível de log para o servidor. - [/Enabled:{Yes | No}] – Habilita ou desabilita o registro em log de ações de cliente dos Serviços de Implantação do Windows. |
| [/WdsUnattend] | Essas configurações controlam o comportamento de instalação autônoma do cliente dos Serviços de Implantação do Windows. Defina as configurações usando as seguintes opções: - [/Policy:{Enabled | Disabled}] – Especifica se a instalação autônoma é usada ou não. |
| [/AutoaddPolicy] | Essas configurações controlam a política de adição automática. Defina as configurações usando as seguintes opções: - [/Policy: {AdminApproval | Disabled}] - AdminApprove faz com que todos os computadores desconhecidos sejam adicionados a uma fila pendente, em que o administrador pode examinar a lista de computadores e aprovar ou rejeitar cada solicitação, conforme apropriado. Desabilitado indica que nenhuma ação adicional é tomada quando um computador desconhecido tenta inicializar no servidor. |
| [/AutoaddSettings] | Especifica as configurações padrão a serem aplicadas a cada computador. Defina as configurações usando as seguintes opções: - /Architecture: {x86 | ia64 | x64} - Especifica a arquitetura. |
| [/BindPolicy] | Configura os adaptadores de rede para o provedor PXE escutar. Defina a política usando as seguintes opções: - [/Policy: {Include | Exclude}] - Define a política de associação de interface para incluir ou excluir os endereços na lista de interfaces. |
| [/RefreshPeriod: <seconds>] | 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 esse GUID será identificado por seu endereço MAC. |
| [/BcdRefreshPolicy] | Define as configurações para atualizar arquivos Bcd usando as seguintes opções: - [/Enabled:{Yes | No}] - especifica a política de atualização Bcd. Quando /Enabled é definido como Sim, os arquivos Bcd são atualizados no intervalo de tempo especificado. |
| [/Transport] | Configura as seguintes opções:
|
Exemplos
Para definir o servidor para responder somente 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 log no servidor, digite:
wdsutil /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings
Para habilitar o autônomo 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 associar às portas TCP 67 e 60, digite:
wdsutil /Set-server /UseDhcpPorts:No /DhcpOption60:Yes