wdsutil set-server

Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Konfiguriert die Einstellungen für einen Windows-Bereitstellungsdienst-Server.

Syntax

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]

Parameter

Parameter	BESCHREIBUNG
[/Server:<Servername>]	Gibt den Namen des Servers an. Hierbei kann es sich um den NetBIOS-Namen oder den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) handeln. Wenn kein Servername angegeben wird, wird der lokale Server verwendet.
[/Authorize:{Yes | No}]	Gibt an, ob dieser Server im Dynamic Host Control Protocol (DHCP) autorisiert wird.
[/RogueDetection:{Yes | No}]	Aktiviert oder deaktiviert die DHCP-Rogue-Erkennung.
[/AnswerClients:{All | Known | None}]	Gibt an, welche Clients von diesem Server eine Antwort erhalten. Wenn Sie diesen Wert auf Known festlegen, muss ein Computer vorab in Active Directory Domain Services (AD DS) bereitgestellt werden, damit er eine Antwort vom Windows-Bereitstellungsdienst-Server erhält.
[/Responsedelay:<Zeit in Sekunden>]	Die Zeit, wie lange der Server wartet, bevor er einem startenden Client antwortet. Diese Einstellung gilt nicht für vorab bereitgestellte Computer.
[/AllowN12forNewClients:{Yes | No}]	Für Windows Server 2008: Gibt an, dass unbekannte Clients nicht die F12-Taste drücken müssen, um einen Netzwerkstart zu initiieren. Bekannte Clients erhalten das für den Computer angegebene Startprogramm oder, wenn keines angegeben ist, das Startprogramm, das für die Architektur festgelegt ist. Für Windows Server 2008 R2: Diese Option wurde durch den folgenden Befehl ersetzt: wdsutil /Set-Server /PxepromptPolicy /New:Noprompt
[/ArchitectureDiscovery:{Yes | No}]	Aktiviert oder deaktiviert die Architekturerkennung. Dies vereinfacht die Erkennung von x64-basierten Clients, die ihre Architektur nicht korrekt übertragen.
[/resetBootProgram:{Yes | No}]	Bestimmt, ob ein Startpfad für einen Client gelöscht wird, der gerade gestartet wurde, ohne dass die F12-Taste gedrückt werden musste.
[/DefaultX86X64Imagetype: {x86 | x64 | Both}]	Steuert, welche Startimages auf x64-basierten Clients angezeigt werden.
[/UseDhcpPorts:{Yes | No}]	Legt fest, ob der PXE-Server versuchen sollte, eine Bindung an DHCP-Port, TCP-Port 67 herzustellen. Wenn DHCP und Windows-Bereitstellungsdienste auf demselben Computer ausgeführt werden, sollten Sie diese Option auf No festlegen, damit der DHCP-Server den Port nutzen kann. Den Parameter /DhcpOption60 sollten Sie auf Yes festlegen. Die Standardeinstellung für diesen Wert ist Yes.
[/DhcpOption60:{Yes | No}]	Gibt an, ob die DHCP-Option 60 für die PXE-Unterstützung konfiguriert werden soll. Wenn DHCP und Windows-Bereitstellungsdienste auf demselben Server ausgeführt werden, legen Sie diese Option auf Yes fest und die Option /UseDhcpPorts auf No. Die Standardeinstellung für diesen Wert ist No.
[/RpcPort:<Portnummer>]	Gibt die TCP-Portnummer an, die für Clientanforderungen genutzt werden soll.
[/PxepromptPolicy]	Konfiguriert, wie bekannte (vorab bereitgestellte) und neue Clients einen PXE-Start initiieren. Diese Option gilt nur für Windows Server 2008 R2. Die Einstellungen legen Sie mit den folgenden Optionen fest: - [/Known:{OptIn|OptOut|Noprompt}] – Legt die Richtlinie für vorab bereitgestellte Clients fest. - [/New:{OptIn|OptOut|Noprompt}] – Legt die Richtlinie für neue Clients fest. OptIn bedeutet, dass der Client eine Taste drücken muss, damit PXE startet, andernfalls wird auf das nächste Startgerät zurückgegriffen. Noprompt bedeutet, dass der Client immer PXE startet. OptOut bedeutet, dass der Client PXE startet, es sei denn, die Esc-Taste wird gedrückt.
[/BootProgram:<Relativer Pfad>] /Architecture:{x86 | ia64 | x64}	Gibt den relativen Pfad zum Startprogramm im Ordner remoteInstall (z. B. boot\x86\pxeboot.n12) und die Architektur des Startprogramms an.
[/N12BootProgram:<Relativer Pfad>] /Architecture:{x86 | ia64 | x64}	Gibt den relativen Pfad zum Startprogramm, bei dem das Drücken der F12-Taste nicht erforderlich ist (z. B. boot\x86\pxeboot.n12), und die Architektur des Startprogramms an.
[/BootImage:<Relativer Pfad>] /Architecture:{x86 | ia64 | x64}	Gibt den relativen Pfad zum Startimage, das die startenden Clients erhalten sollten, und die Architektur des Startimages an. Sie können dies für jede Architektur angeben.
[/PreferredDC:<DC-Name>]	Gibt den Namen des Domänencontrollers an, den Windows-Bereitstellungsdienste verwenden sollen. Das kann der NetBIOS-Name oder der FQDN sein.
[/PreferredGC:<Name des globalen Katalogs>]	Gibt den Namen des globalen Katalogservers an, den Windows-Bereitstellungsdienste verwenden sollen. Das kann der NetBIOS-Name oder der FQDN sein.
[/PrestageUsingMAC:{Yes | No}]	Legt fest, ob Windows-Bereitstellungsdienste beim Erstellen von Computerkonten in AD DS statt der GUID/UUID die MAC-Adresse für die Identifizierung des Computers verwenden sollen.
[/NewMachineNamingPolicy:<Richtlinie>]	Gibt das Format an, das beim Erstellen von Computernamen für Clients verwendet werden soll. Um Informationen zum Format anzuzeigen, das Sie für <Richtlinie> verwenden sollten, klicken Sie im MMC-Snap-In mit der rechten Maustaste auf den Server. Klicken Sie auf Eigenschaften und dann auf die Registerkarte Verzeichnisdienste. Beispiel: /NewMachineNamingPolicy: %61Username%#.
[/NewMachineOU]	Gibt den Speicherort in Ad DS an, an dem die Clientcomputerkonten erstellt werden. Sie geben den Speicherort mit den folgenden Optionen an. - [/type: Serverdomain | Userdomain | UserOU | Custom ] Gibt den Typ des Speicherorts an. Serverdomain erstellt Konten in der Domäne des Windows-Bereitstellungsdienst-Servers. Userdomain erstellt Konten in der Domäne des Benutzers, der die Installation durchführt. UserOU erstellt Konten in der Organisationseinheit des Benutzers, der die Installation durchführt. Mit Custom können Sie einen benutzerdefinierten Speicherort festlegen. (Bei dieser Option müssen Sie auch einen Wert für /OU angeben.) - [/OU:<Domänenname der Organisationseinheit>] – Wenn Sie Custom für die Option /type angeben, legt diese Option die Organisationseinheit fest, in der Computerkonten erstellt werden sollen.
[/DomainSearchOrder:{GCOnly | DCFirst}]	Gibt die Richtlinie für die Suche nach Computerkonten in AD DS an (globaler Katalog oder Domänencontroller).
[/NewMachineDomainJoin:{Yes | No}]	Gibt an, ob ein Computer, der noch nicht vorab in AD DS bereitgestellt ist, bei der Installation der Domäne beitreten soll. Der Standardwert für diese Einstellung ist Ja.
[/WdsClientLogging]	Gibt die Protokollierungsstufe für den Server an. - [/Enabled:{Yes | No}] – Aktiviert oder deaktiviert die Protokollierung der Aktionen des Windows-Bereitstellungsdienst-Clients. - [/LoggingLevel: {None | Errors | Warnings | Info} – Legt die Protokollierungsstufe fest. None deaktiviert die Protokollierung. Errors ist die niedrigste Protokollierungsstufe und gibt an, dass nur Fehler protokolliert werden. Warnings protokolliert Warnungen und Fehler. Info ist die höchste Protokollierungsstufe und umfasst Fehler, Warnungen und Informationsereignisse.
[/WdsUnattend]	Diese Einstellungen steuern das unbeaufsichtigte Installationsverhalten des Windows-Bereitstellungsdienst-Clients. Die Einstellungen legen Sie mit den folgenden Optionen fest: - [/Policy:{Enabled | Disabled}] – Gibt an, ob die unbeaufsichtigte Installation verwendet wird. - [/CommandlinePrecedence: {Yes | No}] – Gibt an, ob bei der Clientinstallation anstelle der Datei für die unbeaufsichtigte Installation des Abbilds die Datei Autounattend.xml (falls auf dem Client vorhanden) oder eine Setupdatei für die unbeaufsichtigte Installation, die mit der Option /Unattend direkt an den Windows-Bereitstellungsdienst-Client übergeben wurde, verwendet wird. Die Standardeinstellung ist No. - [/File:<Relativer Pfad> /Architecture:{x86 | ia64 | x64}] – Gibt den Dateinamen, den Pfad und die Architektur der Datei für die unbeaufsichtigte Installation an.
[/AutoaddPolicy]	Diese Einstellungen steuern die Richtlinie für das automatische Hinzufügen. Sie definieren diese Einstellungen mit den folgenden Optionen: - [/Policy: {AdminApproval | Disabled}] – AdminApproval sorgt dafür, dass alle unbekannten Computer zu einer ausstehenden Warteschlange hinzugefügt werden. Der Administrator kann diese Liste der Computer überprüfen und die einzelnen Anforderungen genehmigen oder ablehnen. Disabled gibt an, dass keine zusätzlichen Aktionen ergriffen werden, wenn ein unbekannter Computer versucht, auf dem Server zu starten. - [/PollInterval:{Zeit in Sekunden}] – Gibt das Zeitintervall (in Sekunden) an, bei dem das Netzwerkstartprogramm den Windows-Bereitstellungsdienst-Server abfragen soll. - [/MaxRetry: <Anzahl>] – Gibt an, wie oft das Netzwerkstartprogramm den Windows-Bereitstellungsdienst-Server abfragen soll. Dieser Wert gibt zusammen mit /PollInterval vor, wie lange das Netzwerkstartprogramm auf die Genehmigung bzw. Ablehnung durch einen Administrator wartet, bevor es zu einer Zeitüberschreitung kommt. Beispiel: Der Wert 10 für MaxRetry und der Wert 60 für PollInterval geben vor, dass der Client den Server 10-mal abfragt und zwischen den einzelnen Versuchen jeweils 60 Sekunden wartet. Nach 10 Minuten (10 x 60 Sekunden = 10 Minuten) käme es zu einer Zeitüberschreitung. - [/Message: <Nachricht>] – Gibt die Nachricht an, die dem Client auf der Dialogfeldseite des Netzwerkstartprogramms angezeigt wird. - [/RetentionPeriod] – Gibt an, wie viele Tage lang sich ein Computer im Status „Ausstehend“ befinden kann, bevor er automatisch gelöscht wird. - [/Approved: <Zeit in Tagen>] – Gibt den Aufbewahrungszeitraum für genehmigte Computer an. Sie müssen diesen Parameter zusammen mit der Option /RetentionPeriod verwenden. - [/Others: <Zeit in Tagen>] – Gibt den Aufbewahrungszeitraum für nicht genehmigte Computer (abgelehnt oder ausstehend) an. Sie müssen diesen Parameter zusammen mit der Option /RetentionPeriod verwenden.
[/AutoaddSettings]	Gibt die Standardeinstellungen an, die auf jeden Computer angewendet werden sollen. Sie definieren diese Einstellungen mit den folgenden Optionen: - /Architecture: {x86 | ia64 | x64} – Gibt die Architektur an. - [/BootProgram: <Relativer Pfad>] – Gibt das Startprogramm an, das an den genehmigten Computer gesendet wird. Wenn kein Startprogramm angegeben ist, wird der Standard für die Architektur des Computers (wie auf dem Server angegeben) verwendet. - [/WdsClientUnattend: <Relativer Pfad>] – Legt den relativen Pfad zur Datei für die unbeaufsichtigte Installation fest, die der genehmigte Client erhalten sollte. - [/ReferralServer: <Servername>] – Gibt den Windows-Bereitstellungsdienst-Server an, den der Client zum Herunterladen der Abbilder verwendet. - [/BootImage: <Relativer Pfad>] – Legt das Startabbild fest, das der genehmigte Client erhält. - [/User: <Domäne\Benutzer | Benutzer@Domäne>] – Legt Berechtigungen für das Computerkontoobjekt fest, um dem angegebenen Benutzer die erforderlichen Rechte für den Beitritt des Computers zur Domäne zu erteilen. - [JoinRights: {JoinOnly | Full}] – Gibt den Typ der Rechte an, die dem Benutzer zugewiesen werden. JoinOnly erfordert, dass der Administrator das Computerkonto zurücksetzt, bevor der Benutzer den Computer in die Domäne einbinden kann. Full gewährt dem Benutzer Vollzugriff. Dazu gehört auch das Recht, dass der Computer der Domäne beitreten kann. - [/JoinDomain: {Yes | No}] – Gibt an, ob der Computer bei einer Windows-Bereitstellungsdienste-Installation der Domäne als dieses Computerkonto beitreten soll. Der Standardwert für diese Einstellung ist Ja.
[/BindPolicy]	Konfiguriert die Netzwerkschnittstellen, die der PXE-Anbieter abhören soll. Sie definieren die Richtlinie mit den folgenden Optionen: - [/Policy: {Include | Exclude}] – Legt fest, ob die Schnittstellenbindungsrichtlinie die Adressen aus der Schnittstellenliste einschließen oder ausschließen soll. - [/add] – Fügt eine Schnittstelle zur Liste hinzu. Sie müssen auch /addresstype und /address angeben. - [/remove] – Entfernt eine Schnittstelle von der Liste. Sie müssen auch /addresstype und /address angeben. - /address:<IP- oder MAC-Adresse> – Gibt die IP- oder MAC-Adresse der Schnittstelle an, die hinzugefügt oder entfernt werden soll. - /addresstype: {IP | MAC} – Gibt den Typ der Adresse an, die in der Option /address angegeben wird.
[/RefreshPeriod: <Sekunden>]	Gibt (in Sekunden) an, wie oft der Server seine Einstellungen aktualisiert.
[/BannedGuidPolicy]	Verwaltet die Liste der gesperrten GUIDs mit den folgenden Optionen: - [/add] /Guid:<GUID> – Fügt die angegebene GUID zur Liste der gesperrten GUIDs hinzu. Jeder Client mit dieser GUID wird stattdessen durch seine MAC-Adresse identifiziert. - [/remove] /Guid:<GUID> – Entfernt die angegebene GUID von der Liste der gesperrten GUIDs.
[/BcdRefreshPolicy]	Konfiguriert die Einstellungen für die Aktualisierung von BCD-Dateien mit den folgenden Optionen: - [/Enabled:{Yes | No}] – Gibt die Richtlinie für die BCD-Aktualisierung an. Wenn /Enabled auf Yes festgelegt ist, werden BCD-Dateien im angegebenen Zeitintervall aktualisiert. - [/RefreshPeriod:<Zeit in Minuten>] – Gibt das Zeitintervall an, in dem BCD-Dateien aktualisiert werden.
[/Transport]	Konfiguriert die folgenden Optionen: [/ObtainIpv4From: {Dhcp | Range}] – Gibt die Quelle von IPv4-Adressen an. [/start: <erste IPv4-Adresse>] – Gibt den Start des IPv4-Adressbereichs an. Diese Option ist erforderlich und gilt nur, wenn /ObtainIpv4From auf Range festgelegt ist. - [/End: <letzte IPv4-Adresse>] – Gibt das Ende des IPv4-Adressbereichs an. Diese Option ist erforderlich und gilt nur, wenn /ObtainIpv4From auf Range festgelegt ist. [/ObtainIpv6From:Range] [/start:<erste IP-Adresse>] [/End:<letzte IP-Adresse>] – Gibt die Quelle von IPv6-Adressen an. Diese Option gilt nur für Windows Server 2008 R2, und der einzige unterstützte Wert ist „Range“. [/startPort: <erster Port>] – Gibt den Start des Portbereichs an. [/EndPort: <letzter Port>] – Gibt das Ende des Portbereichs an. [/Profile: {10Mbps | 100Mbps | 1Gbps | Custom}] – Gibt das zu verwendende Netzwerkprofil an. Diese Option wird nur für Server mit Windows Server 2008 unterstützt. [/MulticastSessionPolicy] – Konfiguriert die Übertragungseinstellungen für Multicastübertragungen. Dieser Befehl ist nur für Windows Server 2008 R2 verfügbar. [/Policy:{None | AutoDisconnect | Multistream}] – Bestimmt, wie langsame Clients behandelt werden sollen. Mit „None“ werden alle Clients in einer Sitzung auf derselben Geschwindigkeit gehalten. Mit „AutoDisconnect“ werden alle Clients getrennt, die unter dem mit /Threshold angegebenen Schwellenwert liegen. Mit „Multistream“ werden Clients in mehrere Sitzungen aufgeteilt, wie durch /StreamCount festgelegt. [/Threshold:<Geschwindigkeit in KBit/s>] – Diese Option legt für /Policy:AutoDisconnect die Mindestübertragungsrate in KBit/s fest. Clients, die unterhalb dieser Rate liegen, werden von Multicastübertragungen getrennt. [/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] – Diese Option bestimmt für /Policy:Multistream die Anzahl an Sitzungen. „2“ bedeutet zwei Sitzungen (schnell und langsam), „3“ bedeutet drei Sitzungen (langsam, mittel, schnell). [/Fallback:{Yes | No}] – Bestimmt, ob getrennte Clients die Übertragung mit einer anderen Methode fortsetzen (sofern diese Möglichkeit vom Client unterstützt wird). Wenn Sie den WDS-Client verwenden, greift der Computer auf Unicasting zurück. Der Fallbackmechanismus wird von Wdsmcast.exe nicht unterstützt. Diese Option gilt auch für Clients, die Multistream nicht unterstützen. In diesem Fall greift der Computer auf eine andere Methode zurück, anstatt zu einer langsameren Übertragungssitzung zu wechseln.

Beispiele

Um festzulegen, dass der Server nur bekannten Clients mit einer Reaktionsverzögerung von 4 Minuten antwortet, geben Sie Folgendes ein:

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

Um das Startprogramm und die Architektur für den Server festzulegen, geben Sie Folgendes ein:

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

Um die Protokollierung auf dem Server zu aktivieren, geben Sie Folgendes ein:

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

Um die unbeaufsichtigte Installation, die Architektur und die Client-Datei für die unbeaufsichtigte Installation zu aktivieren, geben Sie Folgendes ein:

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

Um festzulegen, dass der PXE-Server eine Bindung an den TCP-Ports 67 und 60 herstellen soll, geben Sie Folgendes ein:

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

Verwandte Links

• Erläuterung zur Befehlszeilensyntax
• Befehl wdsutil disable-server
• Befehl wdsutil enable-server
• Befehl wdsutil get-server
• Befehl wdsutil initialize-server
• Befehl wdsutil start-server
• Befehl wdsutil stop-server
• Befehl wdsutil uninitialize-server