Compartilhar via


wdsutil set-server

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.
- [/New:{OptIn|OptOut|Noprompt}] - Define a política para novos clientes.

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).
- [/OU:<Domain name of OU>] - se você especificar Custom para a opção /type, essa opção especificará a unidade organizacional em que as contas de computador devem ser criadas.

[/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.
- [/LoggingLevel: {None | Errors | Warnings | Info} – Define o nível de registro em log. Nenhum é equivalente a desabilitar o registro em log. Erros é o nível mais baixo de registro em log e indica que somente 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. Defina as configurações usando as seguintes opções:

- [/Policy:{Enabled | Disabled}] – Especifica se a instalação autônoma é usada ou não.
- [/CommandlinePrecedence: {Yes | No}] – Especifica se um arquivo de Autounattend.xml (se estiver 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 configuração padrão é No.
- [/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. 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.
- [/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, determina quanto tempo o programa de inicialização de rede aguardará para que um administrador aprove ou rejeite o computador antes de atingir o tempo limite. Por exemplo, um valor MaxRetry de 10 e um valor 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 exibida ao cliente na página de diálogo do programa de inicialização de rede.
- [/RetentionPeriod] - Especifica o número de dias em que um computador pode estar em um estado pendente antes de ser limpo automaticamente.
- [/Approved: <time in days>] - Especifica o período de retenção para computadores aprovados. Você deve usar esse parâmetro com a opção /RetentionPeriod.
- [/Others: <time in days>] - 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. Defina as configurações usando as seguintes opções:

- /Architecture: {x86 | ia64 | x64} - Especifica a arquitetura.
- [/BootProgram: <Relative path>] - Especifica o programa de inicialização enviado ao 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: <Relative path>] - Define o caminho relativo para o arquivo autônomo que o cliente aprovado deve receber.
- [/ReferralServer: <Server name>] - Especifica o servidor dos Serviços de Implantação do Windows que o cliente usará para baixar imagens.
- [/BootImage: <Relative path>] - Especifica a imagem de inicialização que o cliente aprovado receberá.
- [/User: <Domain\User | User@Domain>] - Define permissões no objeto de conta do computador para dar ao usuário especificado os direitos necessários para ingressar o computador no domínio.
- [JoinRights: {JoinOnly | Full}] - Especifica o tipo de direitos a serem atribuídos ao usuário. JoinOnly exige que o administrador redefina a conta do computador antes que o usuário possa ingressar o computador no domínio. Full dá acesso completo ao usuário, incluindo o direito de ingressar o computador no domínio.
- [/JoinDomain: {Yes | No}] - Especifica se o computador deve ou não ser ingressado no domínio como essa conta de computador durante uma instalação dos Serviços de Implantação do Windows. A configuração padrão é Sim.

[/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.
- [/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:<endereço IP ou MAC> - 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: <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.
- [/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:

- [/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.
- [/RefreshPeriod:<time in minutes>] - Especifica o intervalo de tempo no qual os arquivos Bcd são atualizados.

[/Transport] Configura as seguintes opções:

  • [/ObtainIpv4From: {Dhcp | Range}] - Especifica a origem dos endereços IPv4.

    • [/start: <starting Ipv4 address>] - Especifica o início do intervalo de endereços IP. Essa opção é necessária e válida somente se /ObtainIpv4From estiver definido como Intervalo
    • [/End: <Ending Ipv4 address>] - Especifica o final do intervalo de endereços IP. Essa opção é necessária e válida somente se /ObtainIpv4From estiver definido como Intervalo.
  • [/ObtainIpv6From:Range] [/start:<start IP address>] [/End:<End IP address>] Especifica a origem dos endereços IPv6. Essa opção só se aplica ao Windows Server 2008 R2 e o único valor com suporte é Intervalo.
  • [/startPort: <starting port>] - Especifica o início do intervalo de portas.
  • [/EndPort: <Ending port>] - Especifica o fim do intervalo de portas.
  • [/Profile: {10Mbps | 100Mbps | 1Gbps | Custom}] - Especifica o perfil de rede a ser usado. Essa opção só tem suporte para servidores que executam o Windows Server 2008.
  • [/MulticastSessionPolicy] Define as configurações de transferência para transmissões multicast. Esse comando só está disponível para o Windows Server 2008 R2.

    • [/Policy:{None | AutoDisconnect | 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 ficarem abaixo do /Threshold especificado serão desconectados. Multistream significa que os clientes serão separados em várias sessões, conforme especificado por /StreamCount.
    • [/Threshold:<Speed in KBps>] - para /Policy:AutoDisconnect, essa opção define a taxa de transferência mínima em KBps. Os clientes que ficarem abaixo dessa taxa serão desconectados das transmissões multicast.
    • [/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] - para /Policy:Multistream, essa opção determina o número de sessões. 2 significa duas sessões (rápidas e lentas) 3 significa três sessões (lenta, média, rápida).
    • [/Fallback:{Yes | No}] - Determina se os clientes desconectados continuarão a transferência usando outro método (se houver suporte do cliente). Se você estiver usando o cliente WDS, o computador fará fallback para unicasting. Wdsmcast.exe não dá suporte a um mecanismo de fallback. Essa opção também se aplica a clientes que não dão suporte a Multistream. Nesse caso, o computador retornará para outro método em vez de passar para uma sessão de transferência mais lenta.

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