Marco Burmeister

  private Homepage



VMWare ESXi 6.7 - eigene Installations-ISO mit ESXi-Customizer-PS erstellen



Es kommt vor, dass die Standard Installations-ISO-Dateien im Bereich von Homelabs bzw. privaten, selbst zusammengestellten Rechnern einige Geräte nicht erkennen, weil es im normalen Image dafür keine Treiber gibt. Hier kann das Erstellen eines eigenen Installations-Images helfen, wenn dort die fehlenden Treiber eingebunden werden können.

In meinem Fall waren die benötigten Treiber bei v-front.de (siehe auch bei den Links) verfügbar. Das macht das Erstellen des ISO-Files für mich einfacher.
Um herauszufinden, welche Netzwerkkarte im Rechner verbaut ist, verweise ich auf die eigene Dokumentation auf der Seite mit den ESXi Tipps (Helferlein - ESXi Tipps - Netzwerkkarte Realtek 8168).

Diese Seite soll das Vorgehen beschreiben und dient mir als Referenz, weil ich das für ein eigenes Testsystem auch durchführen musste.

Die folgenden Themen haben wir auf der Seite:

Hinweis:
Die Nutzung der hier geschilderten Anleitung geschieht auf eigene Gefahr!



top Vorarbeiten

Damit ich das Image erzeugen konnte, habe ich folgenden Dinge gebraucht:

WICHTIG: Im Zuge der Vorbereitungen müssen für die Powershell noch Module installiert werden.

  1. Prüfen, ob es geeignete Treiber z.B. auf v-front.de (siehe Links) gibt, die eingebunden werden können
  2. Windows 10 Client Rechner mit Powershell Version 5.1.19041.906
    Ich habe hierfür eine eigene VM erstellt, da ich auf meinem "normalen" Client keine Powershell-Erweiterungen für VMWare haben wollte.
  3. Anmeldung an Windows 10 Client als normaler Benutzer
  4. Arbeitsverzeichnis anlegen bzw. für sich selbst festlegen
  5. Herunterladen des Powershell-Scripts (siehe in den Links)
  6. Powershell-Script auf den Windows Client übertragen und im Arbeitsverzeichnis ablegen
  7. Powershell Commandbox öffnen
  8. Powershell Policy/Richtlinie anpassen
    1. Wie ist der aktuelle Stand ? 
      Get-ExecutionPolicy
      oder 
      Get-ExecutionPolicy -list
    2. Policy anpassen:
      (Anmerkung: \ = Zeilenumbruch)
      Set-ExecutionPolicy -ExecutionPolicy unrestricted -Scope currentuser
      
Set-ExecutionPolicy -ExecutionPolicy \ 
unrestricted -Scope currentuser
  9. Powershell Module installieren.

    Ich habe zwei Module installiert, es sollte aber auch mit der Installation des einen richtigen Moduls auch funktionieren.

    1. Installation der Module innerhalb der Powershell Commandbox.

      Neue Powershell Commandbox als Administrator öffnen!
    2. Modul VMware.VimAutomation installieren
      Hier kommt es zu der Rückfrage, ob Software aus einem "Nicht vertrauenswürdiges Repository" installiert werden soll.
      Ferner fragte die Installation nach, ob ebenfalls "NuGet" installiert werden darf.
      Beides habe ich bejaht.

      (Anmerkung: \ = Zeilenumbruch)
      Install-Module -Name VMware.VimAutomation.Core
      
Install-Module -Name \
VMware.VimAutomation.Core
    3. Modul VMware.PowerCLI installieren
      Hier kommt es zu der Rückfrage, ob Software aus einem "Nicht vertrauenswürdiges Repository" installiert werden soll.
      Das habe ich bejaht.

      (Anmerkung: \ = Zeilenumbruch)
      Install-Module -Name VMware.PowerCLI
      
Install-Module -Name \
VMware.PowerCLI
    4. Administrator-Commandbox kann geschlossen werden.



top ISO-Image erstellen

In meinem Fall fehlte ein Treiber für eine Realtek Netzwerkkarte. Hier gab es aber glücklicherweise entsprechende Community-Hilfe.

Die Vorarbeiten müssen durchgeführt worden sein!

  1. Anmelden an Windows 10 Client
  2. Öffnen einer Powershell Commandbox als normaler Nutzer
  3. Wechsel in das in den Vorarbeiten definierte Arbeitsverzeichnis (hier wird später das erstellte ISO-File liegen)
  4. Ein Teil der Syntax kann auch bei anderen Rechnern verwendet werden, um ein ISO-Image zu erzeugen.
    In meinem Fall benötigte ich für die Netzwerkkarte Realtek 8168 einen Treiber. Dieser ist bei v-front unter dem Namen 
    net55-r8168
    zu finden. Außerdem wollte ich noch den Treiber für die Netzwerkkarte Intel E1000 einbinden. Hier ist der Name 
    net-e1000e
    als Referenz anzugeben.
    Der Parameter "-v" erlaubt die Angabe der Version des ESXi für die das Image erzeugt werden soll.
    Hier wird also gleich ein Image für ESXi 6.7 erstellt werden.

    Allgemeine Syntax zum Erstellen eines ISO-Images (im Bereich der kommaseparierten Liste hinter dem Parameter "load", können weitere notwendige Treiber angegeben werden, die dann vom Script in das ISO-Image eingebaut werden:
    (Anmerkung: \ = Zeilenumbruch)
    .\ESXi-Customizer-PS.ps1 -v67 -sip -vft -load esx-ui,sata-xahci,esxcli-shell
    
.\ESXi-Customizer-PS.ps1 -v67 \
-sip -vft \
-load esx-ui,sata-xahci,esxcli-shell

    Konkreter Befehl in meinem Umfeld
    (Anmerkung: \ = Zeilenumbruch)
    .\ESXi-Customizer-PS.ps1 -v67 -sip -vft -load net-e1000e,net55-r8168,esx-ui,sata-xahci,esxcli-shell
    
.\ESXi-Customizer-PS.ps1 -v67 \
-sip -vft -load net-e1000e,net55-r8168,\
esx-ui,sata-xahci,esxcli-shell

    Beispiel-Ausgabe des Laufs:
    (Anmerkung: \ = Zeilenumbruch)
    
.\ESXi-Customizer-PS.ps1 -v67 -sip -vft -load net-e1000e,net55-r8168,esx-ui,sata-xahci,esxcli-shell

This is ESXi-Customizer-PS Version 2.8.1 (visit https://ESXi-Customizer-PS.v-front.de for more information!)
(Call with -help for instructions)

Logging to C:\temp\ESXi-Customizer-PS-4876.log ...

Running with PowerShell version 5.1 and VMware PowerCLI version .. build

Connecting the VMware ESXi Software depot ... [OK]

Connecting the V-Front Online depot ... [OK]

Getting Imageprofiles, please wait ... [OK]

Select Base Imageprofile:
-------------------------------------------
1 : ESXi-6.7.0-20210304001-standard
2 : ESXi-6.7.0-20210304001-no-tools
3 : ESXi-6.7.0-20210301001s-standard
4 : ESXi-6.7.0-20210301001s-no-tools
5 : ESXi-6.7.0-20210204001-standard
6 : ESXi-6.7.0-20210204001-no-tools
7 : ESXi-6.7.0-20201104001-standard
8 : ESXi-6.7.0-20201104001-no-tools
9 : ESXi-6.7.0-20201103001-standard
10 : ESXi-6.7.0-20201103001-no-tools
11 : ESXi-6.7.0-20201101001s-standard
12 : ESXi-6.7.0-20201101001s-no-tools
13 : ESXi-6.7.0-20201004001-standard
14 : ESXi-6.7.0-20201004001-no-tools
15 : ESXi-6.7.0-20200804001-standard
16 : ESXi-6.7.0-20200804001-no-tools
17 : ESXi-6.7.0-20200801001s-standard
18 : ESXi-6.7.0-20200801001s-no-tools
19 : ESXi-6.7.0-20200604001-standard
20 : ESXi-6.7.0-20200604001-no-tools
21 : ESXi-6.7.0-20200404001-standard
22 : ESXi-6.7.0-20200404001-no-tools
23 : ESXi-6.7.0-20200403001-standard
24 : ESXi-6.7.0-20200403001-no-tools
25 : ESXi-6.7.0-20200401001s-standard
26 : ESXi-6.7.0-20200401001s-no-tools
27 : ESXi-6.7.0-20191204001-standard
28 : ESXi-6.7.0-20191204001-no-tools
29 : ESXi-6.7.0-20191201001s-standard
30 : ESXi-6.7.0-20191201001s-no-tools
31 : ESXi-6.7.0-20191104001-standard
32 : ESXi-6.7.0-20191104001-no-tools
33 : ESXi-6.7.0-20190802001-standard
34 : ESXi-6.7.0-20190802001-no-tools
35 : ESXi-6.7.0-20190801001s-standard
36 : ESXi-6.7.0-20190801001s-no-tools
37 : ESXi-6.7.0-20190604001-standard
38 : ESXi-6.7.0-20190604001-no-tools
39 : ESXi-6.7.0-20190504001-standard
40 : ESXi-6.7.0-20190504001-no-tools
41 : ESXi-6.7.0-20190404001-standard
42 : ESXi-6.7.0-20190404001-no-tools
43 : ESXi-6.7.0-20190402001-standard
44 : ESXi-6.7.0-20190402001-no-tools
45 : ESXi-6.7.0-20190401001s-standard
46 : ESXi-6.7.0-20190401001s-no-tools
47 : ESXi-6.7.0-20190304001-standard
48 : ESXi-6.7.0-20190304001-no-tools
49 : ESXi-6.7.0-20190104001-standard
50 : ESXi-6.7.0-20190104001-no-tools
51 : ESXi-6.7.0-20181104001-standard
52 : ESXi-6.7.0-20181104001-no-tools
53 : ESXi-6.7.0-20181004001-standard
54 : ESXi-6.7.0-20181004001-no-tools
55 : ESXi-6.7.0-20181002001-standard
56 : ESXi-6.7.0-20181002001-no-tools
57 : ESXi-6.7.0-20181001001s-standard
58 : ESXi-6.7.0-20181001001s-no-tools
59 : ESXi-6.7.0-20180804001-standard
60 : ESXi-6.7.0-20180804001-no-tools
61 : ESXi-6.7.0-20180704001-standard
62 : ESXi-6.7.0-20180704001-no-tools
63 : ESXi-6.7.0-20180604001-standard
64 : ESXi-6.7.0-20180604001-no-tools
65 : ESXi-6.7.0-8169922-standard
66 : ESXi-6.7.0-8169922-no-tools
-------------------------------------------
Enter selection: 1

Using Imageprofile ESXi-6.7.0-20210304001-standard ...
(Dated 03/04/2021 10:16:14, AcceptanceLevel: PartnerSupported,
Updates ESXi 6.7 Image Profile-ESXi-6.7.0-20210304001-standard)

Load additional VIBs from Online depots ...
   Add VIB net-e1000e 3.2.2.1-2vmw.670.0.0.8169922 [IGNORED, already added]
   Add VIB net55-r8168 8.045a-napi [New AcceptanceLevel: CommunitySupported] [OK, added]
   Add VIB esx-ui 1.34.4-16668064 [OK, replaced 1.33.7-15803439]
   Add VIB sata-xahci 1.42-1 [OK, added]
   Add VIB esxcli-shell 1.1.0-15 [OK, added]

Exporting the Imageprofile to 'C:\MBU\VMWare\ESXi-6.7.0-20210304001-standard-customized.iso'. Please be patient ...


All done.				
			
    
.\ESXi-Customizer-PS.ps1 -v67 \
-sip -vft -load net-e1000e,net55-r8168,\
esx-ui,sata-xahci,esxcli-shell

.\ESXi-Customizer-PS.ps1 -v67 -sip -vft \
-load net-e1000e,net55-r8168,esx-ui,\
sata-xahci,esxcli-shell

This is ESXi-Customizer-PS Version 2.8.1 \
(visit https://ESXi-Customizer-PS.v-front.de\
 for more information!)
(Call with -help for instructions)

Logging to C:\temp\ESXi-Customizer-PS-4876.log ...

Running with PowerShell version 5.1 and \
VMware PowerCLI version .. build

Connecting the VMware ESXi Software depot ... [OK]

Connecting the V-Front Online depot ... [OK]

Getting Imageprofiles, please wait ... [OK]

Select Base Imageprofile:
-------------------------------------------
1 : ESXi-6.7.0-20210304001-standard
2 : ESXi-6.7.0-20210304001-no-tools
3 : ESXi-6.7.0-20210301001s-standard
4 : ESXi-6.7.0-20210301001s-no-tools
5 : ESXi-6.7.0-20210204001-standard
6 : ESXi-6.7.0-20210204001-no-tools
7 : ESXi-6.7.0-20201104001-standard
8 : ESXi-6.7.0-20201104001-no-tools
9 : ESXi-6.7.0-20201103001-standard
10 : ESXi-6.7.0-20201103001-no-tools
11 : ESXi-6.7.0-20201101001s-standard
12 : ESXi-6.7.0-20201101001s-no-tools
13 : ESXi-6.7.0-20201004001-standard
14 : ESXi-6.7.0-20201004001-no-tools
15 : ESXi-6.7.0-20200804001-standard
16 : ESXi-6.7.0-20200804001-no-tools
17 : ESXi-6.7.0-20200801001s-standard
18 : ESXi-6.7.0-20200801001s-no-tools
19 : ESXi-6.7.0-20200604001-standard
20 : ESXi-6.7.0-20200604001-no-tools
21 : ESXi-6.7.0-20200404001-standard
22 : ESXi-6.7.0-20200404001-no-tools
23 : ESXi-6.7.0-20200403001-standard
24 : ESXi-6.7.0-20200403001-no-tools
25 : ESXi-6.7.0-20200401001s-standard
26 : ESXi-6.7.0-20200401001s-no-tools
27 : ESXi-6.7.0-20191204001-standard
28 : ESXi-6.7.0-20191204001-no-tools
29 : ESXi-6.7.0-20191201001s-standard
30 : ESXi-6.7.0-20191201001s-no-tools
31 : ESXi-6.7.0-20191104001-standard
32 : ESXi-6.7.0-20191104001-no-tools
33 : ESXi-6.7.0-20190802001-standard
34 : ESXi-6.7.0-20190802001-no-tools
35 : ESXi-6.7.0-20190801001s-standard
36 : ESXi-6.7.0-20190801001s-no-tools
37 : ESXi-6.7.0-20190604001-standard
38 : ESXi-6.7.0-20190604001-no-tools
39 : ESXi-6.7.0-20190504001-standard
40 : ESXi-6.7.0-20190504001-no-tools
41 : ESXi-6.7.0-20190404001-standard
42 : ESXi-6.7.0-20190404001-no-tools
43 : ESXi-6.7.0-20190402001-standard
44 : ESXi-6.7.0-20190402001-no-tools
45 : ESXi-6.7.0-20190401001s-standard
46 : ESXi-6.7.0-20190401001s-no-tools
47 : ESXi-6.7.0-20190304001-standard
48 : ESXi-6.7.0-20190304001-no-tools
49 : ESXi-6.7.0-20190104001-standard
50 : ESXi-6.7.0-20190104001-no-tools
51 : ESXi-6.7.0-20181104001-standard
52 : ESXi-6.7.0-20181104001-no-tools
53 : ESXi-6.7.0-20181004001-standard
54 : ESXi-6.7.0-20181004001-no-tools
55 : ESXi-6.7.0-20181002001-standard
56 : ESXi-6.7.0-20181002001-no-tools
57 : ESXi-6.7.0-20181001001s-standard
58 : ESXi-6.7.0-20181001001s-no-tools
59 : ESXi-6.7.0-20180804001-standard
60 : ESXi-6.7.0-20180804001-no-tools
61 : ESXi-6.7.0-20180704001-standard
62 : ESXi-6.7.0-20180704001-no-tools
63 : ESXi-6.7.0-20180604001-standard
64 : ESXi-6.7.0-20180604001-no-tools
65 : ESXi-6.7.0-8169922-standard
66 : ESXi-6.7.0-8169922-no-tools
-------------------------------------------
Enter selection: 1

Using Imageprofile \
ESXi-6.7.0-20210304001-standard ...
(Dated 03/04/2021 10:16:14, AcceptanceLevel: \
PartnerSupported,
Updates ESXi 6.7 Image \
Profile-ESXi-6.7.0-20210304001-standard)

Load additional VIBs from Online depots ...
   Add VIB net-e1000e \
   3.2.2.1-2vmw.670.0.0.8169922 \
   [IGNORED, already added]
   Add VIB net55-r8168 8.045a-napi \
   [New AcceptanceLevel: CommunitySupported]\
    [OK, added]
   Add VIB esx-ui 1.34.4-16668064 \
   [OK, replaced 1.33.7-15803439]
   Add VIB sata-xahci 1.42-1 \
   [OK, added]
   Add VIB esxcli-shell 1.1.0-15 \
   [OK, added]

Exporting the Imageprofile to \
'C:\temp\ \
ESXi-6.7.0-20210304001-standard-customized.iso'. \
Please be patient ...


All done.
  5. Fertig - die erstelle ISO-Datei kann nun auf eine CD gebrannt werden.



top Links zum Thema

Hinweis:
Für die Richtigkeit der Daten übernehme ich keine Gewähr!
Für den Inhalt von Internet-Seiten, auf die von dieser Seite verwiesen wird, übernehme ich keine Verantwortung!