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

NameTypeDescriptionRequired?Pipeline InputDefault Value
ImageProfileImageProfile(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
truetrue (ByValue, ByPropertyName)
SoftwarePackageSoftwarePackage[]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.truetrue (ByValue, ByPropertyName)
ConfirmSwitchParameterfalsefalse
ForceSwitchParameterfalsefalse
WarningActionActionPreferencefalsefalse
WarningVariableStringfalsefalse
WhatIfSwitchParameterfalsefalse

Return Type

Notes

Examples

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

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

Remove package foo from my custom profile:


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.