PowerCLI Reference

vSphere Imagebuilder Reference

Remove-EsxSoftwarePackage

Synopsis

Syntax

Remove-EsxSoftwarePackage [-ImageProfile] <ImageProfile> [-SoftwarePackage] <SoftwarePackage[]> [-Force] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Detailed Description

Removes existing packages from an image profile. The output of this cmdlet is an image profile object that you can pipe into any other cmdlet taking image profiles as input.

You cannot modify an image profile if its ReadOnly property is true.

ImageBuilder runs the modified image profile through all image profile validation tests. The modified image profile must have at least a boot kernel so that it can boot. You cannot remove a package if another package depends on it.

Parameters

Name	Type	Description	Required?	Pipeline Input
ImageProfile	ImageProfile	(pipeline input, prompt) Specifies the 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	true	true (ByValue, ByPropertyName)
SoftwarePackage	SoftwarePackage[]	List of software packages to remove from the profile. Specify packages that exist in the profiel. You can specify one or more SoftwarePackage objects, or strings representing package names.	true	true (ByValue, ByPropertyName)
Confirm	SwitchParameter		false	false
Force	SwitchParameter		false	false
WarningAction	ActionPreference		false	false
WarningVariable	String		false	false
WhatIf	SwitchParameter		false	false

Return Type

Notes

Examples

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

Remove-EsxSoftwarePackage -ImageProfile "My custom profile" -SoftwarePackage foo

Remove package foo from my custom profile: