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) のいずれかを指定できます。 サーバー名が指定されていない場合は、ローカルのサーバーが使用されます。
[/Authorize:{Yes | No}] 動的ホスト制御プロトコル (DHCP) でこのサーバーを承認するかどうかを指定します。
[/RogueDetection:{Yes | No}] 有効または DHCP 承認されていない検出を無効にします。
[/AnswerClients:{All | Known | None}] どのクライアントがこのサーバーは応答を指定します。 この値を Known に設定した場合は、コンピューターが Active Directory Domain Services (AD DS) で事前設定してからでないと、Windows 展開サービス サーバーで応答できません。
[/Responsedelay:<時間 (秒単位)>] 起動クライアントに応答する前に、サーバーが待機する時間数。 この設定は、事前設定されたコンピューターには適用されません。
[/AllowN12forNewClients:{Yes | No}] Windows Server 2008 では、未知のクライアントが F12 キーを押してネットワーク ブートを開始する必要がないことを指定します。 既知のクライアントが指定されているブート プログラムを受信するか、または、指定しない場合、ブート プログラム指定アーキテクチャです。

Windows Server 2008 R2 では、このオプションが次のコマンドに置き換えられます: WDSUTIL/Set-Server/PxePromptPolicy/New:NoPrompt

[/ArchitectureDiscovery:{Yes | No}] 有効またはアーキテクチャの検出を無効にします。 これには、そのアーキテクチャを正しくブロードキャストしない x64 ベースのクライアントの検出が容易になります。
[/resetBootProgram:{Yes | No}] クライアントが F12 キーの押下を必要とせず起動したばかりのブート パスが消去されるかどうかを決定します。
[/DefaultX86X64Imagetype: {x86 | x64 | Both}] ブート イメージのコントロールは、x64 ベースのクライアントに表示されます。
[/UseDhcpPorts:{Yes | No}] 指定 TCP ポート 67 で PXE サーバーは、DHCP のポートにバインドしようとする必要があります、かどうか。 DHCP と Windows 展開サービスを同じコンピューターで実行している場合このオプションを設定する必要があります いいえ 、ポートを利用し、設定するには、DHCP サーバーを有効にする、 /DhcpOption60 パラメーターを はいします。 この値は、の既定の設定 はいします。
[/DhcpOption60:{Yes | No}] PXE サポートのために、DHCP オプション 60 を構成するかどうかを指定します。 DHCP と Windows 展開サービスを同じサーバーで実行している場合は、このオプションを設定 はい し、設定、 /UseDhcpPorts オプションを いいえします。 この値は、の既定の設定 いいえします。
[/RpcPort:<ポート番号>] クライアント要求を使用する TCP ポート番号を指定します。
[/PxepromptPolicy] 構成方法既知 (事前設定された) し、新しいクライアントが PXE ブートを開始します。 このオプションは、Windows Server 2008 R2 のみに適用されます。 次のオプションを使用して設定を設定します。

- [/Known:{OptIn|OptOut|Noprompt}] - 事前設定済みクライアントのポリシーを設定します。
- [/New:{OptIn|OptOut|Noprompt}] - 新しいクライアントのポリシーを設定します。

OptIn 手段は、クライアントが PXE ブートするためにキーを押す必要があります、それ以外の場合がフォールバックして、次のブート デバイスです。

Noprompt は、クライアントが常に PXE ブートすることを意味します。

OptOut 、Esc キーが押されていない限り、クライアントが PXE ブートすることを意味します。

[/BootProgram:<相対パス>] /Architecture:{x86 | ia64 | x64} remoteInstall フォルダーにあるブート プログラムへの相対パス (たとえば、 boot\x86\pxeboot.n12) を指定し、ブート プログラムのアーキテクチャを指定します。
[/N12BootProgram:<相対パス>] /Architecture:{x86 | ia64 | x64} F12 キーを押すことを必要としないブート プログラムへの相対パスを指定します (たとえば、 boot\x86\pxeboot.n12)、ブート プログラムのアーキテクチャを指定するとします。
[/BootImage:<相対パス>] /Architecture:{x86 | ia64 | x64} ブート イメージを起動するクライアントを受信する必要があり、ブート イメージのアーキテクチャを指定の相対パスを指定します。 これは、アーキテクチャごとに指定できます。
[/PreferredDC:<DC 名>] Windows 展開サービスが使用するドメイン コント ローラーの名前を指定します。 NetBIOS 名または FQDN を指定できます。
[/PreferredGC:<GC 名>] Windows 展開サービスが使用するグローバル カタログ サーバーの名前を指定します。 NetBIOS 名または FQDN を指定できます。
[/PrestageUsingMAC:{Yes | No}] かどうか、AD DS でコンピューター アカウントを作成するときに、Windows 展開サービスなく使用する MAC アドレスの GUID/UUID コンピューターを識別するためを指定します。
[/NewMachineNamingPolicy:<ポリシー>] クライアント用のコンピューター名を生成するときに使用する形式を指定します。 <ポリシー>に使用する形式の詳細については、mmc スナップインでサーバーを右クリックして [プロパティ] をクリックし、[ディレクトリ サービス] タブを表示します。たとえば、/NewMachineNamingPolicy: %61Username%#
[/NewMachineOU] クライアント コンピューターのアカウントを作成するために使用を AD DS の場所を指定します。 次のオプションを使用して場所を指定します。

- [/type: Serverdomain | Userdomain | UserOU | Custom ] 場所のタイプを指定します。 Serverdomain は、Windows 展開サービス サーバーと同じドメインにアカウントを作成します。 Userdomain は、インストールを実行するユーザーと同じドメインにアカウントを作成します。 UserOU インストールを実行するユーザーの組織単位にアカウントを作成します。 カスタム カスタムの場所を指定することができます (の値を指定する必要がありますも /OU このオプションを使用して)。
-[/OU: <OU のドメイン名>] - /type オプションに Custom を指定した場合、このオプションは、コンピューター アカウントを作成する必要がある組織単位を指定します。

[/DomainSearchOrder:{GCOnly | DCFirst}] AD DS (グローバル カタログまたはドメイン コント ローラー) でコンピューター アカウントを検索するためのポリシーを指定します。
[/NewMachineDomainJoin:{Yes | No}] インストール中に、AD DS に既に事前登録されていないコンピューターをドメインに参加する必要があるかどうかを指定します。 既定の設定は [はい] です。
[/WdsClientLogging] サーバーのログ記録レベルを指定します。

- [/Enabled:{Yes | No}] - Windows 展開サービス クライアント アクションのログを有効または無効にします。
- [/LoggingLevel: {None | Errors | Warnings | Info} - ログ レベルを設定します。 [なし] ログ記録を無効にすることと同じです。 エラー ログの最下位レベルは、エラーのみを記録することを示します。 警告 警告およびエラーの両方が含まれています。 情報 最高レベルのログ記録は、エラー、警告、および情報イベントが含まれています。

[/WdsUnattend] これらの設定は、Windows 展開サービス クライアントの無人インストールの動作を制御します。 次のオプションを使用して設定を設定します。

- [/Policy:{Enabled | Disabled}] - 無人インストールを使用するかどうかを指定します。
- [/CommandlinePrecedence: {Yes | No}] - クライアントのインストール時に、イメージの無人セットアップ ファイルの代わりに、Autounattend.xml ファイル (クライアントに存在する場合)、または /Unattend オプションで Windows 展開サービス クライアントに直接渡される無人セットアップ ファイルを使用するかどうかを指定します。 既定の設定は いいえします。
- [/File:<相対パス> /Architecture:{x86 | ia64 | x64}] - ファイル名、パス、および無人セットアップ ファイルのアーキテクチャを指定します。

[/AutoaddPolicy] これらの設定は、自動追加ポリシーを制御します。 次のオプションを使用して設定を定義します。

- [/Policy: {AdminApproval | Disabled}] - AdminApprove を使用すると、不明なコンピューターがすべて保留中キューに追加されます。管理者は、コンピューターのリストを確認し、必要に応じてそれぞれの要求を承認または拒否することができます。 無効になっている 不明なコンピューターが、サーバーを起動しようとしたときに、追加のアクションが実行しないことを示しています。
- [/PollInterval:{time in seconds}] - ネットワークブートプログラムが Windows 展開サービス サーバーをポーリングする間隔 (秒単位) を指定します。
- [/MaxRetry: <回数>] - ネットワーク ブート プログラムが Windows 展開サービス サーバーをポーリングする回数を指定します。 この値は、/PollInterval とともに、管理者がコンピューターを承認または拒否するのを、ネットワーク ブート プログラムが待機してからタイムアウトするまでの時間を指定します。たとえば、MaxRetry の値が 10、PollInterval の値が 60 の場合、クライアントは毎回 60 秒待ちながらサーバーに 10 回ポーリングします。 そのため、クライアントは、10 分 (10 × 60 秒 = 10 分) 後にタイムアウトとします。
- [/Message: <メッセージ>] - ネットワーク ブート プログラムのダイアログ ページでクライアントに表示するメッセージを指定します。
- [/RetentionPeriod] - コンピューターが自動的にパージされるまで保留状態になる日数を指定します。
- [/Approved: <>] - 承認されたコンピューターの保持期間を指定します。 このパラメーターを使用する必要があります、 /RetentionPeriod オプション。
- [/Others: <>] - 承認されないコンピューターの保持期間を指定します (拒否または保留中)。 このパラメーターを使用する必要があります、 /RetentionPeriod オプション。

[/AutoaddSettings] 各コンピューターに適用される既定の設定を指定します。 次のオプションを使用して設定を定義します。

- /Architecture: {x86 | ia64 | x64} - アーキテクチャを指定します。
- [/BootProgram: <相対パス>] - 承認済みのコンピューターに送信されるブート プログラムを指定します。 ブート プログラムが指定されていない場合 (サーバーの指定) と同じコンピューターのアーキテクチャの既定値が使用されます。
- [/WdsClientUnattend: <Relative path>] - 承認されたクライアントが受け取る無人セットアップ ファイルの相対パスを設定します。
- [/ReferralServer: <Server name>] - クライアントがイメージをダウンロードするときに使用する Windows 展開サービス サーバーを指定します。
- [/BootImage: <相対パス>] - 承認されたクライアントが受け取るブート イメージを指定します。
- [/User: <Domain\User | User@Domain>] - コンピューター アカウント オブジェクトに権限を設定し、コンピューターをドメインに参加させる際に必要な権限を、指定したユーザーに付与します。
- [JoinRights: {JoinOnly |Full}] - ユーザーに割り当てられる権限の種類を指定します。 JoinOnly 管理者ユーザーでコンピューターをドメインに参加する前に、コンピューター アカウントをリセットする必要があります。 完全 フル アクセスをコンピューターをドメインに参加させる権限を含む、ユーザーに与えられます。
- [/JoinDomain: {Yes | No}] - Windows 展開サービスのインストール時に、このコンピューターをこのコンピューター アカウントとしてドメインに参加させるかどうかを指定します。 既定の設定は [はい] です。

[/BindPolicy] リッスンするように PXE プロバイダーのネットワーク インターフェイスを構成します。 次のオプションを使用して、ポリシーを定義します。

- [/Policy: {Include | Exclude}] - インターフェイスの一覧でアドレスを追加または除外するインターフェイスのバインド ポリシーを設定します。
- [/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 ファイルの更新の設定を構成します。

- [/Enabled:{Yes | No}] - ポリシーを更新する Bcd を指定します。 /EnabledYes に設定すると、指定した時間感覚で Bcd ファイルが更新されます。
- [/RefreshPeriod:<>] - Bcd ファイルを更新する時間間隔を指定します。

[/Transport] 次のオプションを構成します。

  • [/ObtainIpv4From: {Dhcp | Range}] - IPv4 アドレスのソースを指定します。

    • [/start: <starting Ipv4 address>] - IP アドレス範囲の最初を指定します。 このオプションは、必要な場合にのみ有効な /ObtainIpv4From に設定されている 範囲
    • [/End: <Ending Ipv4 address>] - IP アドレス範囲の最後を指定します。 このオプションは、必要な場合にのみ有効な /ObtainIpv4From に設定されている 範囲します。
  • [/ObtainIpv6From:Range] [/start:<開始 IP アドレス>] [/End:<終了 IP アドレス>] IPv6 アドレスのソースを指定します。 このオプションは、Windows Server 2008 R2 にのみ適用され、サポートされている値の範囲。
  • [/startPort: <starting port>] - ポート範囲の最初を指定します。
  • [/EndPort: <Ending port>] - ポート範囲の最後を指定します。
  • [/Profile: {10Mbps | 100Mbps | 1Gbps | Custom}] - 使用するネットワーク プロファイルを指定します。 このオプションは、Windows Server 2008 を実行しているサポートされている forservers のみです。
  • [/MulticastSessionPolicy] マルチキャスト転送の転送設定を構成します。 このコマンドでは、Windows Server 2008 R2 の使用のみです。

    • [/Policy:{None | AutoDisconnect | Multistream}] - 低速なクライアントの処理方法を決定します。 [なし] は、すべてのクライアントを同じ速度での 1 つのセッションを維持することです。 自動切断は、指定した/Threshold より下にあるすべてのクライアントが切断されますを意味します。 複数ストリームは、クライアントが/StreamCount で指定された複数のセッションに区切られるようにを意味します。
    • [/Threshold:<速度 (KBps)>] -/Policy:AutoDisconnect の場合、このオプションは最小転送速度を KBps 単位で指定します。 この速度より下にあるクライアントがマルチキャスト転送から切断されます。
    • [/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] - /Policy:Multistream の場合、このオプションはセッションの数を指定します。 2 は、2 つのセッション (高速で低速) 3 は 3 つのセッション (低速、中、高速) を意味します。
    • [/Fallback:{Yes | No}] - 切断されたクライアントが他の方法 (クライアントでサポートされている場合) で転送を継続するかどうかを決定します。 WDS クライアントを使用している場合は、コンピューターのユニキャストへのフォールバック動作します。 Wdsmcast.exe は、フォールバック メカニズムをサポートしていません。 このオプションはサポートしていないクライアントにも適用されます 複数ストリームします。 その場合は、コンピューターは、低速の転送セッションに移動させる代わりに別のメソッドに戻る分類されます。

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

TCP ポート 67 および 60 にバインドしようとする、ブート前実行環境 (PXE) サーバーを設定するには、次のように入力します。

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