Freigeben über

wdsutil set-server

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]

Parameters

Parameter Description
[/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.
[/Autorisieren:{Ja | Nein}] Gibt an, ob dieser Server im Dynamic Host Control Protocol (DHCP) autorisiert wird.
[/RogueDetection:{Ja | Nein}] Aktiviert oder deaktiviert die DHCP-Rogue-Erkennung.
[/AnswerClients:{All | Bekannt | None}] Gibt an, welche Clients von diesem Server eine Antwort erhalten. Wenn Sie diesen Wert auf Bekannt festlegen, muss ein Computer in Active Directory Domain Services (AD DS) vorab bereitgestellt werden, bevor er vom Windows-Bereitstellungsdiensteserver beantwortet wird.
[/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 | Nein}] 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:{Ja | Nein}] Aktiviert oder deaktiviert die Architekturerkennung. Dies vereinfacht die Erkennung von x64-basierten Clients, die ihre Architektur nicht korrekt übertragen.
[/resetBootProgram:{Ja | Nein}] 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 | Beides}] Steuert, welche Startimages auf x64-basierten Clients angezeigt werden.
[/UseDhcpPorts:{Ja | Nein}] 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 Nein festlegen, damit der DHCP-Server den Port verwenden kann, und den Parameter /DhcpOption60 auf Ja festlegen. Die Standardeinstellung für diesen Wert ist Ja.
[/DhcpOption60:{Ja | Nein}] 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 Ja fest, und legen Sie die Option /UseDhcpPorts auf Nein fest. Die Standardeinstellung für diesen Wert ist Nein.
[/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, um PXE-Boot zu starten, andernfalls wird auf das nächste Bootgerät zurückgegriffen.

Noprompt bedeutet, dass der Client immer PXE-Boot ausführt.

OptOut bedeutet, dass der Client per PXE gestartet wird, 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 an (z. B. boot\x86\pxeboot.n12) und gibt die Architektur des Startprogramms an.
[/N12BootProgram:<Relativer Pfad>] /Architecture:{x86 | ia64 | x64} Gibt den relativen Pfad zum Startprogramm an, für das die Taste F12 nicht gedrückt werden muss (z. B. boot\x86\pxeboot.n12), und gibt 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:{Ja | Nein}] 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 für <die Richtlinie> zu erhalten, klicken Sie mit der rechten Maustaste auf den Server im mmc-Snap-In, klicken Sie auf Eigenschaften, und zeigen Sie die Registerkarte Verzeichnisdienste an. 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 derselben Domäne wie der Windows-Bereitstellungsdiensteserver. Userdomain erstellt Konten in derselben Domäne wie der Benutzer, der die Installation ausführt. Die UserOU legt Konten in der Organisationseinheit des Benutzers an, der die Installation durchführt. Benutzerdefiniert ermöglicht es Ihnen, einen benutzerdefinierten Speicherort anzugeben (Sie müssen mit dieser Option auch einen Wert für /OU angeben).
- [/OU:<Domänenname der Organisationseinheit>] - Wenn Sie Benutzerdefiniert für die Option /type angeben, gibt diese Option die Organisationseinheit an, 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:{Ja | Nein}] Gibt an, ob ein Computer, der noch nicht vorab in AD DS bereitgestellt ist, bei der Installation der Domäne beitreten soll. Die Standardeinstellung 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 ist gleichbedeutend mit dem Deaktivieren der Protokollierung. Fehler ist die niedrigste Protokollierungsebene und gibt an, dass nur Fehler protokolliert werden. Warnungen umfassen sowohl Warnungen als auch Fehler. Info ist die höchste Protokollierungsebene 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 Nein.
- [/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:

- [/Richtlinie: {AdminGenehmigung | Disabled}] – AdminApprove bewirkt, dass alle unbekannten Computer zu einer ausstehenden Warteschlange hinzugefügt werden, in der der Administrator dann die Liste der Computer überprüfen und jede Anforderung je nach Bedarf genehmigen oder ablehnen kann. Deaktiviert gibt an, dass keine zusätzliche Aktion ausgeführt wird, wenn ein unbekannter Computer versucht, den 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 bestimmt zusammen mit /PollInterval, wie lange das Netzwerkstartprogramm wartet, bis ein Administrator den Computer genehmigt oder ablehnt, bevor es zu einer Zeitüberschreitung kommt. Ein MaxRetry-Wert von 10 und ein PollInterval-Wert von 60 würden z. B. bedeuten, dass der Client den Server 10 Mal abfragen und zwischen den Versuchen 60 Sekunden warten soll. 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 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 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 der Domäne hinzufügen kann. Vollständig gewährt dem Benutzer vollen Zugriff, einschließlich des Rechts, den Computer mit der Domäne zu verknüpfen.
- [/JoinDomain: {Yes | No}] – Gibt an, ob der Computer bei einer Windows-Bereitstellungsdienste-Installation der Domäne als dieses Computerkonto beitreten soll. Die Standardeinstellung 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 ist.
[/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 Ja 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 nur erforderlich und gültig, wenn /ObtainIpv4From auf Range festgelegt ist
    • - [/End: <letzte IPv4-Adresse>] – Gibt das Ende des IPv4-Adressbereichs an. Diese Option ist nur erforderlich und gültig, 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.

Examples

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
  • Last updated on