powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Add-EsxSoftwarePackage



NAME
Add-EsxSoftwarePackage

SYNOPSIS


SYNTAX
Add-EsxSoftwarePackage [-ImageProfile] [-SoftwarePackage] [-Force] [-WarningActi
on ] [-WarningVariable ] [-WhatIf] [-Confirm] []


DESCRIPTION
Adds new VIBs to an image profile or updates existing VIBs in an image profile. For each package, if it is newer or
older than an existing package in the profile, the existing package will be replaced. Image Builder performs all i
mage profile validation tests on the modified image profile.


The output of this cmdlet may be piped into any other cmdlet taking image profiles as input.


Note that the image profile object that is passed in will have its VibList modified. Please see the New-EsxImagePro
file cmdlet for details about persistence of image profiles.


Modification is not possible if the ReadOnly property of an ImageProfile is true.


PARAMETERS
-ImageProfile
(pipeline input, prompt) Image profile to edit.
Takes one of the following forms:
*Name of an image profile, as displayed in the Name column of Get-EsxImageProfile, or the Name property of any
ImageProfile object
*ImageProfile object

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-SoftwarePackage
(pipeline input, prompt) List of software packages to add to the profile.
Takes one of the following forms:
*Name of a VIB, as displayed in the Name column of Get-EsxSoftwarePackage, or the Name property of any Software
Package object. Image Builder selects the highest available version of the named package.
*" ", for specifying a specific version of a VIB.
*SoftwarePackage object
*GUID of the VIB (from the Guid property of a SoftwarePackage object)
*A list containing a mix of any of the above
If more than one vendor provides a package with the same name, then a non-terminating error results and the cmd
let skips that package.

Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Force
Installs packages that break extensibility rules such as standard file path. Also bypasses dependency checks on
packages. Use this option with care. Because it bypasses standard validation checks, an invalid image profile
might result.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WarningAction


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WarningVariable


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS



NOTES




---------- Example 1 ----------

C:\PS>Add-EsxSoftwarePackage -ImageProfile "My custom profile" -SoftwarePackage net-bnx2


Add a package by name to an image profile:

---------- Example 2 ----------

C:\PS>Add-EsxSoftwarePackage -ImageProfile "My custom profile" -SoftwarePackage "net-bnx2 1.6.7-0.1OEM1"


Add a package of a specific name and version:

---------- Example 3 ----------

C:\PS>New-EsxImageProfile -CloneProfile "ESX-5.0-234567-standard" -Name "My custom profile" | \
Add-EsxSoftwarePackage net-bnx2


Clone an image profile, then add a package by name, in one line using pipelining:


RELATED LINKS