wdsutil set-image

  • Artikel

Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Ändert die Attribute eines Images.

Syntax

für Startimages:

wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>mediatype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>] [/Name:<Name>]
[/Description:<Description>] [/Enabled:{Yes | No}]

für Installationsimages:

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

Parameter

Parameter BESCHREIBUNG
media:<Imagename> Gibt den Namen des Images an.
[/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.
/imagetype:{Boot | Installieren} Gibt den Imagetyp an.
/Architecture:{x86 | ia64 | x64} Gibt die Imagearchitektur an. Da Sie denselben Imagenamen für verschiedene Startimages in unterschiedlichen Architekturen verwenden können, stellt die Angabe der Architektur sicher, dass das richtige Image geändert wird.
[/Filename:<Dateiname>] Wenn das Image anhand des Namens nicht eindeutig identifiziert werden kann, müssen Sie diese Option verwenden, um den Dateinamen anzugeben.
[/Name] Gibt den Namen des Images an.
[/Description:<Beschreibung>] Legt die Imagebeschreibung fest.
[/Enabled:{Ja | Nein}] Aktiviert oder deaktiviert das Image.
\mediaGroup:<Name der Imagegruppe>] Gibt die Imagegruppe an, die das Image enthält. Wenn keine Imagegruppe angegeben wird und nur eine Imagegruppe auf dem Server vorhanden ist, wird diese standardmäßig verwendet. Wenn auf dem Server mehrere Imagegruppen vorhanden sind, müssen Sie mithilfe dieser Option die Imagegruppe angeben.
[/UserFilter:<SDDL>] Legt den Benutzerfilter für das Image fest. Die Filterzeichenfolge muss im SDDL-Format (Security Descriptor Definition Language) vorliegen. Beachten Sie, dass diese Option im Gegensatz zur Imagegruppen-Option /Security nur einschränkt, wer die Imagedefinition anzeigen kann, und nicht die tatsächlichen Imagedateiressourcen. Um den Zugriff auf die Dateiressourcen und damit den Zugriff auf alle Images innerhalb einer Imagegruppe zu beschränken, müssen Sie die Sicherheit für die Imagegruppe selbst festlegen.
[/UnattendFile:<Pfad zur Datei für die unbeaufsichtigte Installation>] Legt den vollständigen Pfad zu der Datei für die unbeaufsichtigte Installation fest, die diesem Image zugeordnet werden soll. Beispiel: D:\Files\Unattend\Img1Unattend.xml
[/OverwriteUnattend:{Ja | Nein}] Sie können /Overwrite angeben, um die Datei für die unbeaufsichtigte Installation zu überschreiben, wenn dem Image bereits eine Datei für die unbeaufsichtigte Installation zugeordnet ist. Beachten Sie, dass die Standardeinstellung Nein ist.

Beispiele

Nehmen Sie zum Festlegen von Werten für ein Startimage eine der folgenden Eingaben vor:

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

Nehmen Sie zum Festlegen von Werten für ein Installationsimage eine der folgenden Eingaben vor:

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