wdsutil set-image
適用於：Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012
變更映像的屬性。
語法
若為開機映像：
wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>mediatype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>] [/Name:<Name>]
[/Description:<Description>] [/Enabled:{Yes | No}]
若為安裝映像：
wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>]
mediatype:InstallmediaGroup:<Image group name>]
[/Filename:<File name>]
[/Name:<Name>]
[/Description:<Description>]
[/UserFilter:<SDDL>]
[/Enabled:{Yes | No}]
[/UnattendFile:<Unattend file path>]
[/OverwriteUnattend:{Yes | No}]
參數
| 參數 | 描述 |
|---|---|
| media:<Image name> | 指定映像的名稱。 |
| [/Server:<Server name>] | 指定伺服器的名稱。 這可以是 NetBIOS 名稱或完整網域名稱 (FQDN) 任一項。 如果未指定任何伺服器名稱，則會使用本機伺服器。 |
| mediatype:{Boot | Install} | 指定映像的類型。 |
| /Architecture:{x86 | ia64 | x64} | 指定映像的架構。 因為在不同的架構中，針對不同的開機映像可以有相同的映像名稱，指定架構可確保修正的是正確的映像。 |
| [/Filename:<File name>] | 如果映像無法以名稱唯一識別，您必須使用此選項來指定檔案名稱。 |
| [/Name] | 指定映像的名稱。 |
| [/Description:<Description>] | 設定映像的描述。 |
| [/Enabled:{Yes | No}] | 啟用或停用映像。 |
| \mediaGroup:<Image group name>] | 指定包含映像的映像群組。 如果未指定映像群組名稱，而且伺服器上只有一個映像群組存在，則將使用該映像群組。 如果伺服器上存在多個映像群組，您必須使用此選項來指定映像群組。 |
| [/UserFilter:<SDDL>] | 設定映像上的使用者篩選條件。 篩選字串必須是安全性描述元定義語言 (SDDL) 格式。 請注意，不同於映像群組的 /Security 選項，此選項只會限制誰可以看到映像定義，而不是實際的映像檔案資源。 若要限制檔案資源的存取權，因此影響到存取映像群組內的所有映像，您必須設定映像群組本身的安全性。 |
| [/UnattendFile:<Unattend file path>] | 設定與映像相關聯的自動安裝檔案的完整路徑。 例如：D:\Files\Unattend\Img1Unattend.xml |
| [/OverwriteUnattend:{Yes | No}] | 如果已經有與映像相關聯的自動安裝檔案，您可以指定 /Overwrite 來覆寫自動安裝檔案。 請注意，預設設定為 No。 |
範例
若要設定開機映像的值，請輸入下列其中一項：
wdsutil /Set-Imagmedia:WinPE boot imagemediatype:Boot /Architecture:x86 /Description:New description
wdsutil /verbose /Set-Imagmedia:WinPE boot image /Server:MyWDSServemediatype:Boot /Architecture:x86 /Filename:boot.wim
/Name:New Name /Description:New Description /Enabled:Yes
若要設定安裝映像的值，請輸入下列其中一項：
wdsutil /Set-Imagmedia:Windows Vista with Officemediatype:Install /Description:New description
wdsutil /verbose /Set-Imagmedia:Windows Vista with Office /Server:MyWDSServemediatype:InstalmediaGroup:ImageGroup1
/Filename:install.wim /Name:New name /Description:New description /UserFilter:O:BAG:DUD:AI(A;ID;FA;;;SY)(A;ID;FA;;;BA)(A;ID;0x1200a9;;;AU) /Enabled:Yes /UnattendFile:\\server\share\unattend.xml /OverwriteUnattend:Yes