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

Editing Image Profiles Workflow, Example: Creating Image Profiles from Scratch Using Variables

Page 245 highlights

Chapter 7 Installing ESXi The system expects that the acceptance level of the VIBs you add to the base image is at least as high as the level of the base image. Pass in the -AcceptanceLevel parameter to change the acceptance level of the image profile if you have to add a VIB with a lower acceptance level. As an alternative to specifying the parameters on the command line, you can use the PowerShell prompting mechanism to specify string parameters. Prompting does not work for other parameters such as objects. The following workflow illustrates creating image profiles from scratch. 1 At the PowerShell prompt, add the depot that contains the packages you want to use to the current session. For remote depots, run Add-EsxSoftwareDepot -DepotUrl depot_url. For an offline depot ZIP file, you must download the ZIP file first. a Download the ZIP file to a local file path. b Run Add-EsxSoftwareDepot -DepotUrl C:\file_path\offline-bundle.zip 2 List the available packages that you are interested in and bind them to a variable. Get-EsxSoftwarePackage -CreatedAfter 7/1/2010 3 Create a new profile, assign it a name and vendor, and add a base package. New-EsxImageProfile -NewProfile -Name "Test #2" -vendor "Vendor42" -SoftwarePackage esxbase[0] The example uses the esx-base package. In most cases, you include the esx-base package when you create an image profile from scratch. Names that contain spaces are surrounded by quotes. 4 Pipe the information about the new image profile to format-list for detailed information about the new package. (Get-EsxImageProfile -Name "Test #2").VibList | format-list Example: Creating Image Profiles from Scratch Using Variables This command sequence repeats the steps of the workflow, but passes parameters as objects, accessed by position in a variable, instead of passing parameters by name. You can run the following commands in sequence from the PowerCLI prompt. Add-EsxSoftwareDepot depoturl $pkgs = Get-EsxSoftwarePackage -CreatedAfter 7/1/2010 $ip2 = New-EsxImageProfile -Name "Test #2" -vendor "Vendor42" -SoftwarePackage $pkgs[0] $ip2 | format-list Editing Image Profiles Workflow You can create a custom image by cloning and editing an image profile. You can add or replace one or more VIBs in the existing profile. If adding or replacing VIBs would make the image profile inconsistent, an error results. Before you use the cmdlets in this workflow, make sure your environment meets the following requirements. n VMware PowerCLI and prerequisite is software installed. See "Install Image Builder PowerCLI and Prerequisite Software," on page 233. n You have access to a depot that includes a base image and one or more VIBs. VMware and VMware partners make public depots, accessible by a URL, available. VMware or VMware partners can create a ZIP file that you can download to your local environment and access by using a file path. 1 At the PowerShell prompt, add the depot that contains the image profile that you want to edit to the current session. VMware, Inc. 245

  • 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

The system expects that the acceptance level of the VIBs you add to the base image is at least as high as the
level of the base image. Pass in the
-AcceptanceLevel
parameter to change the acceptance level of the image
profile if you have to add a VIB with a lower acceptance level.
As an alternative to specifying the parameters on the command line, you can use the PowerShell prompting
mechanism to specify string parameters. Prompting does not work for other parameters such as objects.
The following workflow illustrates creating image profiles from scratch.
1
At the PowerShell prompt, add the depot that contains the packages you want to use to the current
session.
For remote depots, run
Add-EsxSoftwareDepot -DepotUrl
depot_url
.
For an offline depot ZIP file, you must download the ZIP file first.
a
Download the ZIP file to a local file path.
b
Run
Add-EsxSoftwareDepot -DepotUrl C:\
file_path
\
offline-bundle
.zip
2
List the available packages that you are interested in and bind them to a variable.
Get-EsxSoftwarePackage -CreatedAfter 7/1/2010
3
Create a new profile, assign it a name and vendor, and add a base package.
New-EsxImageProfile -NewProfile -Name "Test #2" -vendor "Vendor42" -SoftwarePackage esx-
base[0]
The example uses the esx-base package. In most cases, you include the esx-base package when you
create an image profile from scratch. Names that contain spaces are surrounded by quotes.
4
Pipe the information about the new image profile to
format-list
for detailed information about the
new package.
(Get-EsxImageProfile -Name "Test #2").VibList | format-list
Example: Creating Image Profiles from Scratch Using Variables
This command sequence repeats the steps of the workflow, but passes parameters as objects, accessed by
position in a variable, instead of passing parameters by name. You can run the following commands in
sequence from the PowerCLI prompt.
Add-EsxSoftwareDepot
depoturl
$pkgs = Get-EsxSoftwarePackage -CreatedAfter 7/1/2010
$ip2 = New-EsxImageProfile -Name "Test #2" -vendor "Vendor42" -SoftwarePackage $pkgs[0]
$ip2 | format-list
Editing Image Profiles Workflow
You can create a custom image by cloning and editing an image profile. You can add or replace one or more
VIBs in the existing profile. If adding or replacing VIBs would make the image profile inconsistent, an error
results.
Before you use the cmdlets in this workflow, make sure your environment meets the following
requirements.
n
VMware PowerCLI and prerequisite is software installed. See
“Install Image Builder PowerCLI and
Prerequisite Software,”
on page 233.
n
You have access to a depot that includes a base image and one or more VIBs. VMware and VMware
partners make public depots, accessible by a URL, available. VMware or VMware partners can create a
ZIP file that you can download to your local environment and access by using a file path.
1
At the PowerShell prompt, add the depot that contains the image profile that you want to edit to the
current session.
Chapter 7 Installing ESXi
VMware, Inc.
245