wdsutil set-server

Область применения: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Настраивает параметры сервера служб развертывания Windows.

Синтаксис

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]

Параметры

Параметр Описание
[/Server:<Имя> сервера] Указывает имя сервера. Это может быть имя NetBIOS или полное доменное имя (FQDN). Если имя сервера не указано, локальный сервер будет использоваться.
[/Авторизовать:{Да | Нет}] Указывает, следует ли авторизовать этот сервер в протоколе управления динамическим узлом (DHCP).
[/RogueDetection:{Да | Нет}] Включает или отключает обнаружение изгоев DHCP.
[/AnswerClients:{All | Известный | None}] Указывает, какие клиенты будут отвечать на этот сервер. Если для этого значения задано значение "Известный", компьютер должен быть предварительно настроен в доменных службах Active Directory (AD DS), прежде чем он будет отвечать на сервер служб развертывания Windows.
[/Responsedelay:<time в секундах>] Время ожидания сервера перед ответом на загрузочный клиент. Этот параметр не применяется к предварительно подготовленным компьютерам.
[/AllowN12forNewClients:{Да | Нет}] для Windows Server 2008 указывает, что неизвестным клиентам не придется нажимать клавишу F12, чтобы инициировать загрузку сети. Известные клиенты получат программу загрузки, указанную для компьютера, или, если она не указана, программа загрузки, указанная для архитектуры.

для Windows Server 2008 R2 этот параметр заменен следующей командой: wdsutil /Set-Server /PxepromptPolicy /New:Noprompt

[/ArchitectureDiscovery:{Да | Нет}] Включает или отключает обнаружение архитектуры. Это упрощает обнаружение клиентов на основе x64, которые не передают архитектуру правильно.
[/resetBootProgram:{Да | Нет}] Определяет, будет ли путь загрузки удален для клиента, который только что загружен без нажатия клавиши F12.
[/DefaultX86X64Imagetype: {x86 | x64 | Оба}] Определяет, какие образы загрузки будут отображаться клиентам на основе x64.
[/UseDhcpPorts:{Да | Нет}] Указывает, должен ли сервер PXE пытаться привязаться к DHCP-порту, TCP-порту 67. Если службы РАЗВЕРТЫВАНИЯ DHCP и Windows выполняются на одном компьютере, установите для этого параметра значение "Нет ", чтобы включить DHCP-сервер для использования порта и задать для параметра /DhcpOption60 значение "Да". Значение по умолчанию — "Да".
[/DhcpOption60:{Да | Нет}] Указывает, следует ли настроить параметр DHCP 60 для поддержки PXE. Если службы РАЗВЕРТЫВАНИЯ DHCP и Windows выполняются на одном сервере, задайте для этого параметра значение "Да " и установите для параметра /UseDhcpPorts значение No. Значение по умолчанию для этого значения равно No.
[/RpcPort:<Номер> порта] Указывает номер TCP-порта, используемый для обслуживания клиентских запросов.
[/PxepromptPolicy] Настройка того, как известные (предварительно подготовленные) и новые клиенты инициируют загрузку PXE. Этот параметр применяется только к Windows Server 2008 R2. Параметры задаются с помощью следующих параметров:

- [/Известный:{OptIn|OptOut |Noprompt}] — задает политику для предварительно подготовленных клиентов.
- [/New:{OptIn|OptOut |Noprompt}] — задает политику для новых клиентов.

OptIn означает, что клиент должен нажать клавишу, чтобы загрузить PXE, в противном случае он вернется к следующему загрузочному устройству.

Noprompt означает, что клиент всегда будет загружать PXE.

OptOut означает, что клиент будет загружать PXE, если клавиша ESC не нажата.

[/BootProgram:<Относительный путь>] /Архитектура:{x86 | ia64 | x64} Указывает относительный путь к загрузочной программе в папке remoteInstall (например, boot\x86\pxeboot.n12) и задает архитектуру загрузочной программы.
[/N12BootProgram:<Относительный путь>] /Архитектура:{x86 | ia64 | x64} Указывает относительный путь к загрузочной программе, не требующей нажатия клавиши F12 (например, boot\x86\pxeboot.n12) и задает архитектуру программы загрузки.
[/BootImage:<Относительный путь>] /Архитектура:{x86 | ia64 | x64} Указывает относительный путь к загрузочному образу, который должен получать клиенты загрузки, и задает архитектуру загрузочного образа. Это можно указать для каждой архитектуры.
[/PreferredDC:<Имя> контроллера домена] Указывает имя контроллера домена, который следует использовать службам развертывания Windows. Это может быть имя NetBIOS или полное доменное имя.
[/PreferredGC:<Имя> GC] Указывает имя сервера глобального каталога, который следует использовать службам развертывания Windows. Это может быть имя NetBIOS или полное доменное имя.
[/PrestageUsingMAC:{Да | Нет}] Указывает, должны ли службы развертывания Windows при создании учетных записей компьютеров в AD DS использовать MAC-адрес, а не ИДЕНТИФИКАТОР GUID/UUID для идентификации компьютера.
[/NewMachineNamingPolicy:<Политика>] Задает формат, используемый при создании имен компьютеров для клиентов. Для получения сведений о формате, используемом для <политики, щелкните правой кнопкой мыши сервер в оснастке mmc, выберите пункт "Свойства" и перейдите на вкладку "Службы каталогов>". Например, /NewMachineNamingPolicy: %61Username%#.
[/NewMachineOU] Используется для указания расположения в AD DS, где будут созданы учетные записи клиентского компьютера. Укажите расположение с помощью следующих параметров.

- [/type: serverdomain | Userdomain | UserOU | Custom ] Указывает тип расположения. Серверный домен создает учетные записи в том же домене, что и сервер служб развертывания Windows. Userdomain создает учетные записи в том же домене, что и пользователь, выполняющий установку. UserOU создает учетные записи в подразделении пользователя, выполняющего установку. Custom позволяет указать пользовательское расположение (необходимо также указать значение для /OU с помощью этого параметра).
— [/OU:<Доменное имя подразделения>] — если для параметра /type указан пользовательскийпараметр, этот параметр указывает подразделение, в котором должны быть созданы учетные записи компьютеров.

[/DomainSearchOrder:{GCOnly | DCFirst}] Указывает политику поиска учетных записей компьютеров в AD DS (глобальный каталог или контроллер домена).
[/NewMachineDomainJoin:{Да | Нет}] Указывает, следует ли присоединять компьютер, который еще не настроен в AD DS, к домену во время установки. Значение по умолчанию — "Да".
[/WdsClientLogging] Указывает уровень ведения журнала для сервера.

- [/Включено:{Да | No}] — включает или отключает ведение журнала действий клиента служб развертывания Windows.
- [/LogLevel: {None | Ошибки | Предупреждения | Info} — задает уровень ведения журнала. Ни один из них не эквивалентен отключению ведения журнала. Ошибки — это самый низкий уровень ведения журнала и указывает, что будут регистрироваться только ошибки. Предупреждения включают как предупреждения, так и ошибки. Сведения — это самый высокий уровень ведения журнала и включает ошибки, предупреждения и информационные события.

[/WdsUnattend] Эти параметры управляют поведением автоматической установки клиента служб развертывания Windows. Параметры задаются с помощью следующих параметров:

- [/Policy:{Включено | Отключено}] — указывает, используется ли автоматическая установка.
- [/CommandlinePrecedence: {Да | No}] — указывает, будет ли Autounattend.xml файл (если он присутствует на клиенте) или файл автоматической установки, переданный непосредственно клиенту служб развертывания Windows с параметром /Unattend, будет использоваться вместо автоматического файла образа во время установки клиента. Значение по умолчанию: Нет.
— [/File:Относительный путь /Архитектура:<{x86 | ia64 | x64}] — задает имя файла, путь> и архитектуру автоматического файла.

[/AutoaddPolicy] Эти параметры управляют политикой автоматической добавления. Параметры определяются с помощью следующих параметров:

- [/Policy: {Администратор Approval | Отключено}] — Администратор Approve приводит к добавлению всех неизвестных компьютеров в очередь ожидания, где администратор может просмотреть список компьютеров и утвердить или отклонить каждый запрос соответствующим образом. Отключено указывает, что никаких дополнительных действий не выполняется, когда неизвестный компьютер пытается загрузиться на сервер.
— [/PollInterval:{время в секундах}] — указывает интервал (в секундах), в котором программа загрузки сети должна опросить сервер служб развертывания Windows.
— [/MaxRetry: <number>] — указывает количество раз, когда программа загрузки сети должна опрашивает сервер служб развертывания Windows. Это значение вместе с параметром /PollInterval определяет, сколько времени программа загрузки сети будет ожидать, пока администратор утвердит или отклонит компьютер до истечения времени ожидания. Например, значение MaxRetry 10 и vlue PollInterval 60 указывает, что клиент должен опрашивал сервер 10 раз, ожидая 60 секунд между попытками. Таким образом, клиент истекает через 10 минут (10 x 60 секунд = 10 минут).
- [/Message: <Message] — указывает сообщение>, отображаемое клиенту на странице диалогового окна программы загрузки сети.
— [/RetentionPeriod] — указывает количество дней, в которых компьютер может находиться в состоянии ожидания, прежде чем автоматически очищаться.
— [/Утверждено: <время в днях>] — указывает срок хранения для утвержденных компьютеров. Этот параметр необходимо использовать с параметром /RetentionPeriod .
— [/Другие: <время в днях>] — указывает срок хранения для неутвержденных компьютеров (отклонен или ожидающих). Этот параметр необходимо использовать с параметром /RetentionPeriod .

[/Autoadd Параметры] Указывает параметры по умолчанию, применяемые к каждому компьютеру. Параметры определяются с помощью следующих параметров:

— /Архитектура: {x86 | ia64 | x64} — задает архитектуру.
- [/BootProgram: <относительный путь>] — указывает программу загрузки, отправленную на утвержденный компьютер. Если программа загрузки не указана, будет использоваться значение по умолчанию для архитектуры компьютера (как указано на сервере).
- [/WdsClientUnattend: <относительный путь] — задает относительный путь> к автоматическому файлу, который должен получать утвержденный клиент.
— [/ReferralServer: <имя> сервера] — указывает сервер служб развертывания Windows, который клиент будет использовать для скачивания образов.
— [/BootImage: <относительный путь>] — указывает образ загрузки, который будет получать утвержденный клиент.
- [/User: <Domain\User | >User@Domain] — задает разрешения на объект учетной записи компьютера, чтобы предоставить указанному пользователю необходимые права для присоединения компьютера к домену.
- [JoinRights: {JoinOnly | Full}] — указывает тип прав, назначенных пользователю. JoinOnly требует, чтобы администратор сбрасывал учетную запись компьютера, прежде чем пользователь сможет присоединить компьютер к домену. Полный доступ предоставляет пользователю полный доступ, включая право присоединить компьютер к домену.
- [/JoinDomain: {Да | No}] — указывает, следует ли присоединение компьютера к домену в качестве учетной записи компьютера во время установки служб развертывания Windows. Значение по умолчанию — "Да".

[/BindPolicy] Настраивает сетевые интерфейсы для поставщика PXE для прослушивания. Вы определяете политику с помощью следующих параметров:

- [/Policy: {Include | Исключение}] — задает политику привязки интерфейса для включения или исключения адресов в списке интерфейсов.
- [/add] — добавляет интерфейс в список. Необходимо также указать /addresstype и /address.
— [/remove] — удаляет интерфейс из списка. Необходимо также указать /addresstype и /address.
— /address:<IP или MAC-адрес> — указывает IP-адрес или MAC-адрес интерфейса для добавления или удаления.
- /addresstype: {IP | MAC} — указывает тип адреса, указанного в параметре /address .

[/RefreshPeriod: <секунды>] Указывает частоту обновления параметров сервера (в секундах).
[/BannedGuidPolicy] Управляет списком запрещенных идентификаторов GUID с помощью следующих параметров:

— [/add] /GUID:<GUID — добавляет указанный GUID> в список запрещенных идентификаторов GUID. Вместо этого любой клиент с этим ИДЕНТИФИКАТОРом GUID будет определяться своим MAC-адресом.
— [/remove] /GUID:<GUID — удаляет указанный GUID> из списка запрещенных идентификаторов GUID.

[/BcdRefreshPolicy] Настраивает параметры для обновления файлов Bcd с помощью следующих параметров:

- [/Включено:{Да | No}] — задает политику обновления Bcd. Если для параметра /Enabled задано значение "Да", файлы Bcd обновляются с заданным интервалом времени.
— [/RefreshPeriod:<time в минутах>] — указывает интервал времени обновления файлов Bcd.

[/Транспорт] Настраивает следующие параметры:

  • [/GetIpv4From: {Dhcp | Range}] — указывает источник IPv4-адресов.

    • [/start: <start Ipv4 address>] — указывает начало диапазона IP-адресов. Этот параметр является обязательным и допустимым, только если для параметра /GetIpv4From задано значение Range
    • [/End: <Конечный IPv4-адрес>] — указывает конец диапазона IP-адресов. Этот параметр является обязательным и допустимым, только если для параметра /GetIpv4From задано значение Range.
  • [/GetIpv6From:Range] [/start:<IP-адрес>] [/End:<End IP-адрес>] Указывает источник IPv6-адресов. Этот параметр применяется только к Windows Server 2008 R2, а единственное поддерживаемое значение — Range.
  • [/startPort: <начальный порт>] — указывает начало диапазона портов.
  • [/EndPort: <Конечный порт>] — указывает конец диапазона портов.
  • [/Profile: {10Mbps | 100 Мбps | 1 Гбит/с | Custom}] — указывает используемый сетевой профиль. Этот параметр поддерживается только для серверов под управлением Windows Server 2008.
  • [/MulticastSessionPolicy] Настраивает параметры передачи многоадресной рассылки. Эта команда доступна только для Windows Server 2008 R2.

    • [/Policy:{None | AutoDisconnect | Multistream}] — определяет, как обрабатывать медленные клиенты. Никто не означает, чтобы все клиенты в одном сеансе были одинаковыми. AutoDisconnect означает, что все клиенты, которые опускаются ниже указанного /Порогового значения, будут отключены. Многопоток означает, что клиенты будут разделены на несколько сеансов, как указано в параметре /StreamCount.
    • [/Порог:<Скорость в КБ ps>] — для /Policy:AutoDisconnect, этот параметр задает минимальную скорость передачи в КБ ps. Клиенты, которые опускаются ниже этой частоты, будут отключены от многоадресной передачи.
    • [/StreamCount:{2 | 3}] [/Fallback:{Да | No}] — для /Policy:Multistream этот параметр определяет количество сеансов. 2 означает два сеанса (быстро и медленно) 3 означает три сеанса (медленные, средние, быстрые).
    • [/Fallback:{Да | No}] — определяет, будут ли отключены клиенты продолжать передачу с помощью другого метода (если он поддерживается клиентом). Если вы используете клиент WDS, компьютер откатится к одноадресной рассылке. Wdsmcast.exe не поддерживает резервный механизм. Этот параметр также применяется к клиентам, которые не поддерживают multistream. В этом случае компьютер откатится к другому методу вместо перехода к более медленному сеансу передачи.

Примеры

Чтобы задать серверу ответить только на известных клиентов, с задержкой ответа в течение 4 минут введите:

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

Чтобы задать программу загрузки и архитектуру сервера, введите следующее:

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

Чтобы включить ведение журнала на сервере, введите следующее:

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

Чтобы включить автоматическую настройку на сервере, а также архитектуру и автоматический файл клиента, введите следующее:

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

Чтобы задать сервер среды выполнения предварительной загрузки (PXE), чтобы попытаться привязаться к TCP-портам 67 и 60, введите следующее:

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