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}]

parameters

参数 说明
media:<映像名> 指定映像的名称。
[/Server:<Server name>] 指定服务器的名称。 可以是 NetBIOS 名称或完全限定域名 (FQDN)。 如果未指定服务器名称，将使用本地服务器。
mediatype:{Boot | Install} 指定映像的类型。
/Architecture:{x86 | ia64 | x64} 指定映像的体系结构。 由于不同体系结构中的不同启动映像可能具有相同的映像名称，因此请指定体系结构以确保使用正确的映像。
[/Filename:<File name>] 如果无法按名称唯一标识映像，则必须使用此选项指定文件名。
[/Name] 指定映像的名称。
[/Description:<Description>] 设置映像的说明。
[/Enabled:{是 | 否}] 启用或禁用映像。
\mediaGroup:<映像组名>] 指定包含映像的映像组。 如果未指定映像组名，并且服务器上只有一个映像组，则将使用该映像组。 如果服务器上存在多个映像组，则必须使用此选项指定映像组。
[/UserFilter:<SDDL>] 在映像上设置用户筛选器。 筛选器字符串必须采用安全描述符定义语言 (SDDL) 格式。 请注意，与映像组的 /Security 选项不同，此选项仅限定谁可以查看映像定义，不限定实际的映像文件资源。 若要限制对文件资源的访问，从而限制对映像组中所有映像的访问，需为映像组本身设置安全性。
[/UnattendFile:<无人参与文件路径>] 设置要与映像关联的无人参与文件的完整路径。 例如：D:\Files\Unattend\Img1Unattend.xml
[/OverwriteUnattend:{是 | 否}] 如果已有与映像关联的无人参与文件，你可以指定 /Overwrite 以覆盖该无人参与文件。 请注意，默认设置为“否”。

示例

若要设置启动映像的值，请键入以下命令之一：

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