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

Using Image Builder Cmdlets, Procedure, What to do next, Passing Parameters by Name

Page 234 highlights

vSphere Installation and Setup Procedure 1 Install Microsoft .NET 2.0 from the Microsoft website following the instructions on that website. 2 Install Microsoft PowerShell 2.0. from the Microsoft website following the instructions on that website. 3 Install vSphere PowerCLI, which includes the Image Builder cmdlets. See the vSphere PowerCLI Installation Guide for detailed instructions. What to do next Review "Using Image Builder Cmdlets," on page 234.If you are new to PowerCLI, read the PowerCLI documentation. Use Image Builder cmdlets and other PowerCLI cmdlets and PowerShell cmdlets to manage image profiles and VIBs. Use Get-Help cmdlet_name at any time for command-line help. Using Image Builder Cmdlets Image Builder cmdlets are implemented as Microsoft PowerShell cmdlets and included in VMware PowerCLI. Users of Image Builder cmdlets can take advantage of all PowerCLI features. Experienced PowerShell users can use Image Builder cmdlets just like other PowerShell cmdlets. If you are new to PowerShell and PowerCLI, the following tips help you come up to speed. You can type cmdlets, parameters, and parameter values in the PowerCLI shell. n Get help for any cmdlet by running Get-Help cmdlet_name. n Remember that PowerShell is not case sensitive. n Use tab completion for cmdlet names and parameter names. n Format any variable and cmdlet output by using Format-List or Format-Table or their short forms fl or ft. See Get-Help Format-List. Passing Parameters by Name You can pass in parameters by name in most cases and surround parameter values that contain spaces or special characters with double quotes. Add-EsxSoftwarePackage -ImageProfile profile42 -SoftwarePackage "partner package 35" Passing Parameters as Objects You can pass parameters as objects if you want to do scripting and automation. You can use the technique with cmdlets that return multiple objects or with cmdlets that return a single object. 1 Bind the output of a cmdlet that returns multiple objects to a variable. $profs = Get-EsxImageProfile 2 When you run the cmdlet that needs the object as input, access the object by position, with the list starting with 0. Add-EsxSoftwarePackage -ImageProfile $profs[4] -SoftwarePackage partner-pkg The example adds the specified software package to the fifth image profile in the list returned by GetEsxImageProfile. Most examples in the documentation pass in parameters by name. "Image Builder Workflows," on page 242 includes examples that pass parameters as objects. 234 VMware, Inc.

  • 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

Procedure
1
Install Microsoft .NET 2.0 from the Microsoft website following the instructions on that website.
2
Install Microsoft PowerShell 2.0. from the Microsoft website following the instructions on that website.
3
Install vSphere PowerCLI, which includes the Image Builder cmdlets.
See the
vSphere PowerCLI Installation Guide
for detailed instructions.
What to do next
Review
“Using Image Builder Cmdlets,”
on page 234.If you are new to PowerCLI, read the PowerCLI
documentation.
Use Image Builder cmdlets and other PowerCLI cmdlets and PowerShell cmdlets to manage image profiles
and VIBs. Use
Get-Help
cmdlet_name
at any time for command-line help.
Using Image Builder Cmdlets
Image Builder cmdlets are implemented as Microsoft PowerShell cmdlets and included in VMware
PowerCLI. Users of Image Builder cmdlets can take advantage of all PowerCLI features.
Experienced PowerShell users can use Image Builder cmdlets just like other PowerShell cmdlets. If you are
new to PowerShell and PowerCLI, the following tips help you come up to speed.
You can type cmdlets, parameters, and parameter values in the PowerCLI shell.
n
Get help for any cmdlet by running
Get-Help
cmdlet_name
.
n
Remember that PowerShell is not case sensitive.
n
Use tab completion for cmdlet names and parameter names.
n
Format any variable and cmdlet output by using
Format-List
or
Format-Table
or their short forms
fl
or
ft
. See
Get-Help Format-List
.
Passing Parameters by Name
You can pass in parameters by name in most cases and surround parameter values that contain spaces or
special characters with double quotes.
Add-EsxSoftwarePackage -ImageProfile profile42 -SoftwarePackage "partner package 35"
Passing Parameters as Objects
You can pass parameters as objects if you want to do scripting and automation. You can use the technique
with cmdlets that return multiple objects or with cmdlets that return a single object.
1
Bind the output of a cmdlet that returns multiple objects to a variable.
$profs = Get-EsxImageProfile
2
When you run the cmdlet that needs the object as input, access the object by position, with the list
starting with 0.
Add-EsxSoftwarePackage -ImageProfile $profs[4] -SoftwarePackage partner-pkg
The example adds the specified software package to the fifth image profile in the list returned by
Get-
EsxImageProfile
.
Most examples in the documentation pass in parameters by name.
“Image Builder Workflows,”
on page 242
includes examples that pass parameters as objects.
vSphere Installation and Setup
234
VMware, Inc.