PowerCLI Reference

vSphere Imagebuilder Reference

Get-EsxSoftwarePackage

Synopsis

Syntax

Get-EsxSoftwarePackage [[-Name] <String[]>] [[-Version] <String[]>] [-Vendor <String[]>] [-AcceptanceLevel <AcceptanceLevels[]>] [-CreatedBefore <DateTime>] [-CreatedAfter <DateTime>] [-Newest] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Detailed Description

Returns a list of SoftwarePackage (VIB) objects from all the connected depots, filtered by one or more options. The output is in table form by default. You can pass VIB package names and versions to the New-EsxImageProfile, Set-EsxImageProfile, Add-EsxSoftwarePackage, and Remove-EsxSoftwarePackage cmdlets via the -SoftwarePackage parameter.

The output of this cmdlet can also be piped into Add-EsxSoftwarePackage and Remove-EsxSoftwarePackage. See the examples under those cmdlets.

Parameters

Name	Type	Description	Required?	Pipeline Input
Name	String[]	Filters the output to list only VIBs whose Name field matches one of the strings supplied. Wildcard characters are supported.	false	false
Version	String[]	Filters the output to list only VIBs whose Version field matches one of the strings supplied. Wildcard characters are supported.	false	false
AcceptanceLevel	AcceptanceLevels[]	Filters the output to list only VIBs whose acceptance level matches one of the strings supplied. Must be one of the following values: * VMwareCertified * VMwareAccepted * PartnerSupported * CommunitySupported	false	false
Confirm	SwitchParameter		false	false
Newest	SwitchParameter	Filters the output to list only the newest versions of all VIBs. For example, if there are two versions of the "Base-ESX" VIB, "5.0.0-10", and "5.0.0-456", returns only Base-ESX version "5.0.0-456".	false	false
CreatedAfter	DateTime	Filters the output to list only VIBs whose CreationDate is at the earliest the DateTime value supplied. Can be a string of the form MM/DD/YY.	false	false
CreatedBefore	DateTime	Filters the output list to only VIBs whose CreationDate is at the latest the DateTime value supplied. Can be a string of the form MM/DD/YY.	false	false
Vendor	String[]	Filters the output to list only VIBs whose Vendor field matches one of the strings supplied. Wildcard characters are supported.	false	false
WarningAction	ActionPreference		false	false
WarningVariable	String		false	false
WhatIf	SwitchParameter		false	false

Return Type

Notes

Examples

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

Get-EsxSoftwarePackage

List all the VIBs from all depots in table form:

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

Get-EsxSoftwarePackage | Sort-Object CreationDate | Format-Table -Property Name,Version,Vendor

List all the VIBs, sorted by date:

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

Get-EsxSoftwarePackage -Vendor "VMware","Cisco" -CreatedAfter 1/1/2010

List all the VIBs from VMware and Cisco created after Jan 1, 2010:

---------- Example 4 ----------

Get-EsxSoftwarePackage | ? {$_.Vendor -ne "VMware"}

List all the VIBs from vendors other than VMware

---------- Example 5 ----------

Get-EsxSoftwarePackage -Name "esx-base" -Version "5.0.0-*"

List all the base VIBs for the 5.0.0 release:

---------- Example 6 ----------

$vibs = Get-EsxSoftwarePackage -Name "esx-base" -Version "5.0.0-*"

Save the results of a VIB query for later: