wdsutil set-server

Si applica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Configura le impostazioni per un server di servizi di distribuzione Windows.

Sintassi

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]

Parametri

Parametro Descrizione
[/Server:<Nome server>] Specifica il nome del server. Può essere il nome NetBIOS oppure il nome di dominio completo. Se viene specificato alcun nome di server, verrà utilizzato il server locale.
[/Authorize:{Yes | No}] Specifica se autorizzare il server di controllo protocollo DHCP (Dynamic Host).
[/RogueDetection:{Yes | No}] Abilita o disabilita il rilevamento rogue DHCP.
[/AnswerClients:{All | Known | None}] Specifica che i client risponderà a questo server. Se si imposta questo valore su Known, il computer deve essere pre-installato in Active directory Domain Services (AD DS) prima che venga restituita una risposta dal server di servizi di distribuzione Windows.
[/Responsedelay:<tempo in secondi>] La quantità di tempo che il server attenderà prima di rispondere a un client di avvio. Questa impostazione non è applicabile ai computer pre-installazione.
[/AllowN12forNewClients:{Yes | No}] per Windows Server 2008, specifica che i client sconosciuti non saranno necessario premere il tasto F12 per inizializzare un avvio di rete. I client riceveranno il programma di avvio specificato per il computer oppure, se non specificato, il programma di avvio specificato per l'architettura.

per Windows Server 2008 R2, questa opzione è stata sostituita con il comando seguente: wdsutil /Set-Server /PxepromptPolicy /New:Noprompt

[/ArchitectureDiscovery:{Yes | No}] Abilita o disabilita il rilevamento di architettura. Questo facilita l'individuazione di client basati su x64 che non trasmettere correttamente la relativa architettura.
[/resetBootProgram:{Yes | No}] Determina se il percorso di avvio verrà cancellato per un client che ha appena avviata senza richiedere una pressione di F12.
[/DefaultX86X64Imagetype: {x86 | x64 | Both}] Verranno visualizzati i controlli che le immagini di avvio per i client basati su x64.
[/UseDhcpPorts:{Yes | No}] Specifica se il server PXE deve tentare di associare la porta DHCP, TCP porta 67. Se DHCP e servizi di distribuzione Windows sono in esecuzione nello stesso computer, è necessario impostare questa opzione n per consentire al server DHCP utilizzare la porta e impostare il /DhcpOption60 parametro . L'impostazione predefinita per questo valore è .
[/DhcpOption60:{Yes | No}] Specifica se l'opzione DHCP 60 deve essere configurato per il supporto PXE. Se DHCP e servizi di distribuzione Windows sono in esecuzione nello stesso server, impostare questa opzione su e impostare il /UseDhcpPorts opzione n. L'impostazione predefinita per questo valore è n.
[/RpcPort:<Numero porta>] Specifica il numero di porta TCP da utilizzare per gestire le richieste client.
[/PxepromptPolicy] Configura come noti (pre-installati) e i nuovi client avviano un avvio PXE. Questa opzione si applica solo a Windows Server 2008 R2. Impostare le impostazioni utilizzando le opzioni seguenti:

- [/Known:{OptIn|OptOut|Noprompt}] - Imposta i criteri per i client pre-installati.
- [/New:{OptIn|OptOut|Noprompt}] - imposta i criteri per i nuovi client.

OptIn significa che il client richiede di premere un tasto nell'ordine di avvio PXE, in caso contrario ricorre al dispositivo di avvio successivo.

Noprompt significa che il client verrà sempre avvio PXE.

OptOut significa che il client registrerà avvio PXE, a meno che non viene premuto il tasto Esc.

[/BootProgram:<Percorso relativo>] /Architecture:{x86 | ia64 | x64} Specifica il percorso relativo del programma di avvio nella cartella remoteInstall (ad esempio, boot\x86\pxeboot.n12) e specifica l'architettura del programma di avvio.
[/N12BootProgram:<Percorso relativo>] /Architecture:{x86 | ia64 | x64} Specifica il percorso relativo del programma di avvio che non è necessario premere il tasto F12 (ad esempio, boot\x86\pxeboot.n12) e specifica l'architettura del programma di avvio.
[/BootImage:<Percorso relativo>] /Architecture:{x86 | ia64 | x64} Specifica il percorso relativo all'immagine di avvio che i client devono ricevere e specifica l'architettura dell'immagine di avvio. È possibile specificare questo per ogni architettura.
[/PreferredDC:<Nome Dc>] Specifica il nome del controller di dominio che deve utilizzare servizi di distribuzione Windows. Questo può essere il nome NetBIOS o il nome FQDN.
[/PreferredGC:<Nome GC>] Specifica il nome del server di catalogo globale che deve utilizzare servizi di distribuzione Windows. Questo può essere il nome NetBIOS o il nome FQDN.
[/PrestageUsingMAC:{Yes | No}] Specifica se servizi di distribuzione Windows, durante la creazione di account di dominio Active Directory, deve utilizzare l'indirizzo MAC anziché il GUID/UUID per identificare il computer.
[/NewMachineNamingPolicy:<Criteri>] Specifica il formato da utilizzare durante la generazione di nomi di computer per i client. Per informazioni sul formato da utilizzare per <i criteri>, fare clic con il pulsante destro del mouse sul server nello snap-in mmc, scegliere Proprietà e visualizzare la scheda Servizi directory. Ad esempio, /NewMachineNamingPolicy: %61Username%#.
[/NewMachineOU] Utilizzato per specificare il percorso in Active Directory in cui verranno creati account dei computer client. Specificare il percorso utilizzando le opzioni seguenti.

- [/type: Serverdomain | Userdomain | UserOU | Custom ] Specifica il tipo di percorso. Serverdomain crea account nello stesso dominio del server di servizi di distribuzione Windows. Userdomain crea account nello stesso dominio dell'utente che esegue l'installazione. UserOU Crea gli account nell'unità organizzativa dell'utente che esegue l'installazione. Personalizzata consente di specificare un percorso personalizzato (è inoltre necessario specificare un valore per /OU con questa opzione).
- [/OU:<Nome di dominio dell'unità organizzativa>] - se si specifica Personalizzato per l'opzione /type , questa opzione specifica l'unità organizzativa in cui devono essere creati gli account computer.

[/DomainSearchOrder:{GCOnly | DCFirst}] Specifica i criteri per la ricerca di account di dominio Active Directory (global catalog o controller di dominio).
[/NewMachineDomainJoin:{Yes | No}] Specifica se un computer che non è già preventivamente in Active Directory deve appartenere al dominio durante l'installazione. L'impostazione predefinita è .
[/WdsClientLogging] Specifica il livello di registrazione per il server.

- [/Enabled:{Yes | No}] - Abilita o disabilita la registrazione delle azioni del client Servizi di distribuzione Windows.
- [/LoggingLevel: {None | Errors | Warnings | Info} - Imposta il livello di registrazione. Nessuno equivale a disabilitare la registrazione. Errori è il livello più basso di registrazione e indica che solo gli errori verranno registrati. Avvisi include errori e avvisi. Info è il massimo livello di registrazione e include gli errori, avvisi e gli eventi informativi.

[/WdsUnattend] Queste impostazioni controllano il comportamento di installazione automatica del client di servizi di distribuzione Windows. Impostare le impostazioni utilizzando le opzioni seguenti:

- [/Policy:{Enabled | Disabled}] - Specifica se viene utilizzata l'installazione automatica.
- [/ CommandlinePrecedence: {Sì | No}] - Specifica se un file Autounattend. XML (se presente sul client) o un file di installazione automatica passato direttamente al client di servizi di distribuzione Windows con l'opzione /Unattend verrà utilizzato invece di un file di installazione automatica immagine durante l'installazione client. L'impostazione predefinita è No.
- [/File:<Percorso relativo> /Architecture:{x86 | ia64 | x64}] - Specifica il nome del file, il percorso e l'architettura del file di installazione automatica.

[/AutoaddPolicy] Queste impostazioni controllano il criterio di aggiunta automatica. Definire le impostazioni utilizzando le opzioni seguenti:

- [/Policy: {AdminApproval | Disabled}]: AdminApprove fa sì che tutti i computer sconosciuti da aggiungere a una coda in sospeso, in cui l'amministratore può quindi esaminare l'elenco dei computer e approvare o rifiutare ogni richiesta, come appropriato. Disabilitato indica che quando un computer sconosciuto tenta di avvio per il server non viene eseguita alcuna azione aggiuntiva.
-[/PollInterval: {time in seconds}]-Specifica l'intervallo (in secondi) in cui il programma di avvio di rete deve eseguire il polling server di servizi di distribuzione Windows.
- [/MaxRetry: <Numero>] - Specifica il numero di volte in cui il programma di avvio di rete deve eseguire il polling del server Servizi di distribuzione Windows. Questo valore, insieme a /PollInterval, determina per quanto tempo il programma di avvio di rete attenderà che un amministratore approvi o rifiuti il computer prima del timeout. Ad esempio, un valore MaxRetry pari a 10 e un valore vlue PollInterval pari a 60 indica che il client deve eseguire il polling del server 10 volte, in attesa di 60 secondi tra i tentativi. Di conseguenza, il client viene timeout dopo 10 minuti (10 x 60 secondi = 10 minuti).
- [/Message: <Messaggio>] - Specifica il messaggio che viene visualizzato al client nella pagina di dialogo del programma di avvio di rete.
-[/RetentionPeriod] - Specifica il numero di giorni di che un computer può essere in stato di attesa prima di essere eliminati automaticamente.
- [/Approved: <tempo in giorni>] - Specifica il periodo di conservazione per i computer approvati. È necessario utilizzare questo parametro con il /RetentionPeriod (opzione).
- [/Others: <tempo in giorni>] - Specifica il periodo di conservazione per i computer non approvati (rifiutati o in sospeso). È necessario utilizzare questo parametro con il /RetentionPeriod (opzione).

[/AutoaddSettings] Specifica le impostazioni predefinite da applicare a ogni computer. Definire le impostazioni utilizzando le opzioni seguenti:

- /Architecture: {x86 | ia64 | x64} - specifica l'architettura.
- [/BootProgram: <Percorso relativo>] - Specifica il programma di avvio inviato al computer approvato. Se non viene specificato alcun programma di avvio, verrà utilizzato il valore predefinito per l'architettura del computer (come specificato nel server).
- [/WdsClientUnattend: <Percorso relativo>] - Imposta il percorso relativo del file di installazione automatica che il client approvato deve ricevere.
- [/ReferralServer: <Nome server>] - Specifica il server Servizi di distribuzione Windows che il client userà per scaricare le immagini.
- [/BootImage: <Percorso relativo>] - Specifica l'immagine di avvio che riceverà il client approvato.
- [/User: <Domain\User | User@Domain>] - Imposta le autorizzazioni sull'oggetto account computer per conferire all'utente specifico i diritti necessari per aggiungere il computer al dominio.
- [JoinRights: {JoinOnly | Full}] - Specifica il tipo di diritti da assegnare all'utente. JoinOnly richiede che l'amministratore reimpostare l'account del computer prima che l'utente può aggiungere il computer al dominio. Completa fornisce l'accesso completo all'utente, compreso il diritto di aggiungere il computer al dominio.
- [/JoinDomain: {Sì | No}] - Specifica se il computer deve appartenere al dominio come account di questo computer durante un'installazione di servizi di distribuzione Windows. L'impostazione predefinita è .

[/BindPolicy] Consente di configurare le interfacce di rete per il provider PXE in ascolto. Si definiscono i criteri utilizzando le opzioni seguenti:

- [/Policy: {Include | Exclude}] - imposta i criteri di associazione dell'interfaccia per includere o escludere gli indirizzi nell'elenco di interfaccia.
- [/add] - Aggiunge un'interfaccia all'elenco. È inoltre necessario specificare /addresstype e /address.
-[/remove] - Rimuove un'interfaccia dall'elenco. È inoltre necessario specificare /addresstype e /address.
- /address:<IP o MAC address> - Specifica l'indirizzo IP o MAC dell'interfaccia da aggiungere o rimuovere.
- /addresstype: {IP | MAC} - indica il tipo di indirizzo specificato nell'opzione /address.

[/RefreshPeriod: <secondi>] Specifica la frequenza (in secondi) il server verrà Aggiorna le relative impostazioni.
[/BannedGuidPolicy] Gestisce l'elenco di GUID da escludere utilizzando le opzioni seguenti:

- [/add] /Guid:<GUID> - Aggiunge il GUID specificato all'elenco di GUID da escludere. Qualsiasi client con tale GUID verrà identificato dal relativo indirizzo MAC.
- [/remove] /Guid:<GUID> - Rimuove il GUID specificato dall'elenco di GUID da escludere.

[/BcdRefreshPolicy] Configura le impostazioni per l'aggiornamento dei file Bcd utilizzando le seguenti opzioni:

- [/Enabled:{Yes | No}] - Specifica i criteri di aggiornamento del Ccd. Quando /Enabled è impostato su Yes, i file Bcd vengono aggiornati all'intervallo di tempo specificato.
- [/RefreshPeriod:<tempo in minuti>] - Specifica l'intervallo di tempo in cui i file Bcd vengono aggiornati.

[/Transport] Configura le opzioni seguenti:

  • [/ObtainIpv4From: {Dhcp | Range}] - Specifica l'origine di indirizzi IPv4.

    • [/start: <starting Ipv4 address>] - Specifica l'inizio dell'intervallo di indirizzi IP. Questa opzione è obbligatoria e valido solo se /ObtainIpv4From è impostato su intervallo
    • [/End: <Ending Ipv4 address>] - Specifica la fine dell'intervallo di indirizzi IP. Questa opzione è obbligatoria e valido solo se /ObtainIpv4From è impostato su intervallo.
  • [/ObtainIpv6From:Intervallo] [/start:<indirizzo IP iniziale>] [/End:<Indirizzo IP finale>] Specifica l'origine degli indirizzi IPv6. Questa opzione si applica solo a Windows Server 2008 R2 ed è l'unico valore supportato intervallo.
  • [/startPort: <porta di inizio>] - Specifica l'inizio dell'intervallo di porte.
  • [/EndPort: <Porta di fine>] - Specifica la fine dell'intervallo di porte.
  • [/Profile: {10Mbps | 100Mbps | 1Gbps | Custom}] - Specifica il profilo di rete da utilizzare. Questa opzione è solo supportata forservers che esegue Windows Server 2008.
  • [/MulticastSessionPolicy] Configura le impostazioni di trasferimento per trasmissioni multicast. Questo comando è disponibile solo per Windows Server 2008 R2.

    • [/Policy:{None | AutoDisconnect | Multistream}] - Determina come gestire i client lenti. Nessuno significa che mantenere tutti i client in una sessione alla stessa velocità. Disconnessione automatica, che i client che scendono di sotto di /Threshold specificato verranno disconnesse. Ausiliaria significa che i client saranno separati in più sessioni come specificato da /StreamCount.
    • [/Threshold:<Velocità in KBps>] - per /Policy:AutoDisconnect, questa opzione imposta la velocità di trasferimento minima in KBps. I client che scendono di sotto questa frequenza verranno disconnesso da trasmissioni multicast.
    • [/ StreamCount:{2 | 3}] [/Fallback:{Yes | No}] - per /Policy:Multistream, questa opzione determina il numero di sessioni. 2 indica due sessioni (veloce e lento) 3 rappresenta (lenta, Media, fast) e tre le sessioni.
    • [/ Fallback: {Sì | No}] - determina se i client vengono disconnessi continueranno il trasferimento in un altro metodo (se supportato dal client). Se si utilizza il client di servizi di distribuzione Windows, il computer eseguirà il fallback per l'unicast. Wdsmcast.exe non supporta un meccanismo di fallback. Questa opzione si applica anche ai client che non supportano ausiliaria. In tal caso, il computer tornerà a un altro metodo anziché spostarsi a una sessione di trasferimento più lenta.

Esempi

Per impostare il server risponda solo a client noti, con un ritardo di risposta di 4 minuti, digitare:

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

Per impostare il programma di avvio e l'architettura per il server, digitare:

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

Per abilitare la registrazione nel server, digitare:

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

Per consentire di installazione automatica nel server, nonché l'architettura e il file di installazione automatica del client, digitare:

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

Per impostare il server di Pre-Boot Execution Environment (PXE) per tentare di associare le porte TCP 67 e 60, digitare:

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