VMware VS4-ENT-PL-A Setup Guide - Page 237

Export an Image Profile to ISO or Offline Bundle ZIP

Page 237 highlights

Chapter 7 Installing ESXi 3 Clone the profile. New-EsxImageProfile -CloneProfile My_Profile -Name "Test Profile 42" -Vendor "My Vendor" Image profiles published by VMware and its partners are read only. To make changes, you clone the image profile. The vendor parameter is required. 4 Run Add-EsxSoftwarePackage to add a new package to one of the image profile. Add-EsxSoftwarePackage -ImageProfile My_Profile -SoftwarePackage partner-package The cmdlet runs the standard validation tests on the image profile. If validation succeeds, the cmdlet returns a modified, validated image profile. If the VIB that you want to add depends on a different VIB, the cmdlet displays that information and includes the VIB that would resolve the dependency. If the acceptance level of the VIB that you want to add is lower than the image profile acceptance level, an error results. Change the acceptance level of the image profile to add the VIB. 5 (Optional) Change the acceptance level of the image profile if an error about acceptance level problems displays. VIB acceptance levels are set during VIB creation and cannot be changed. The image profile includes the new VIB. Export an Image Profile to ISO or Offline Bundle ZIP You can export an image profile to an ISO image or a ZIP file of component files and folders. You cannot create both by running the cmdlet once. You can use the ISO image as an ESXi installer or upload the ISO into vSphere Update Manager for upgrades. You can use the ZIP file, which contains metadata and the VIBs specified in the image profile, for upgrades to ESXi 5.0 and later. Administrators performing this task must have some experience with PowerCLI or Microsoft PowerShell. Prerequisites n Install the VMware PowerCLI and all prerequisite software. See "Install Image Builder PowerCLI and Prerequisite Software," on page 233. n If you encounter problems running PowerCLI cmdlets, consider changing the execution policy. See "Using Image Builder Cmdlets," on page 234. Procedure 1 Run Add-EsxSoftwareDepot to connect to the depot that contains the image profile to export. Depot Type Remote depot ZIP file Cmdlet Run Add-EsxSoftwareDepot -DepotUrl depot_url. a Download the ZIP file to a local file path. b Run Add-EsxSoftwareDepot -DepotUrl C:\file_path\offlinebundle.zip The cmdlet returns one or more SoftwareDepot objects. 2 Run Export-EsxImageProfile to export the image profile. To build... ISO images Offline depot ZIP files Run... Export-EsxImageProfile with the -ExportToIso parameter. Export-EsxImageProfile with the -ExportToBundle parameter. VMware, Inc. 237

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276

3
Clone the profile.
New-EsxImageProfile -CloneProfile My_Profile -Name "Test Profile 42" -Vendor "My Vendor"
Image profiles published by VMware and its partners are read only. To make changes, you clone the
image profile. The
vendor
parameter is required.
4
Run
Add-EsxSoftwarePackage
to add a new package to one of the image profile.
Add-EsxSoftwarePackage -ImageProfile My_Profile -SoftwarePackage partner-package
The cmdlet runs the standard validation tests on the image profile. If validation succeeds, the cmdlet
returns a modified, validated image profile. If the VIB that you want to add depends on a different VIB,
the cmdlet displays that information and includes the VIB that would resolve the dependency. If the
acceptance level of the VIB that you want to add is lower than the image profile acceptance level, an
error results. Change the acceptance level of the image profile to add the VIB.
5
(Optional) Change the acceptance level of the image profile if an error about acceptance level problems
displays.
VIB acceptance levels are set during VIB creation and cannot be changed.
The image profile includes the new VIB.
Export an Image Profile to ISO or Offline Bundle ZIP
You can export an image profile to an ISO image or a ZIP file of component files and folders. You cannot
create both by running the cmdlet once. You can use the ISO image as an ESXi installer or upload the ISO
into vSphere Update Manager for upgrades. You can use the ZIP file, which contains metadata and the VIBs
specified in the image profile, for upgrades to ESXi 5.0 and later.
Administrators performing this task must have some experience with PowerCLI or Microsoft PowerShell.
Prerequisites
n
Install the VMware PowerCLI and all prerequisite software. See
“Install Image Builder PowerCLI and
Prerequisite Software,”
on page 233.
n
If you encounter problems running PowerCLI cmdlets, consider changing the execution policy. See
“Using Image Builder Cmdlets,”
on page 234.
Procedure
1
Run
Add-EsxSoftwareDepot
to connect to the depot that contains the image profile to export.
Depot Type
Cmdlet
Remote depot
Run
Add-EsxSoftwareDepot -DepotUrl
depot_url
.
ZIP file
a
Download the ZIP file to a local file path.
b
Run
Add-EsxSoftwareDepot -DepotUrl C:\
file_path
\
offline-
bundle
.zip
The cmdlet returns one or more
SoftwareDepot
objects.
2
Run
Export-EsxImageProfile
to export the image profile.
To build...
Run...
ISO images
Export-EsxImageProfile
with the
-ExportToIso
parameter.
Offline depot ZIP files
Export-EsxImageProfile
with the
-ExportToBundle
parameter.
Chapter 7 Installing ESXi
VMware, Inc.
237