vSphere PowerCLI Reference

Get-EsxSoftwarePackage

Synopsis

Syntax

Get-EsxSoftwarePackage [[-Name] <String[]>] [[-Version] <String[]>] [-Vendor <String[]>] [-AcceptanceLevel <AcceptanceLevels[]>] [-ReleasedBefore <DateTime>] [-ReleasedAfter <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

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Filters the output to list only VIBs whose Name field matches one of the strings supplied. Wildcard characters are supported.falsefalse
VersionString[]Filters the output to list only VIBs whose Version field matches one of the strings supplied. Wildcard characters are supported.falsefalse
AcceptanceLevelAcceptanceLevels[]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
falsefalse
ConfirmSwitchParameterfalsefalse
NewestSwitchParameterFilters 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".falsefalse
ReleasedAfterDateTimeFilters the output to list only VIBs whose ReleaseDate is at the earliest the DateTime value supplied. Can be a string of the form MM/DD/YY.falsefalse
ReleasedBeforeDateTimeFilters the output list to only VIBs whose ReleaseDate is at the latest the DateTime value supplied. Can be a string of the form MM/DD/YY.falsefalse
VendorString[]Filters the output to list only VIBs whose Vendor field matches one of the strings supplied. Wildcard characters are supported.falsefalse
WarningActionActionPreferencefalsefalse
WarningVariableStringfalsefalse
WhatIfSwitchParameterfalsefalse

Return Type

Notes

Examples

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

Get-EsxSoftwarePackage

List all the VIBs from all depots in table form:

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

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

List all the VIBs, sorted by date:

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

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

List all the VIBs from VMware and Cisco released 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:


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