Get-EsxSoftwarePackage

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.

Syntax

[[-Version]  <String[]>]
[-AcceptanceLevel  <AcceptanceLevels[]>]
[-CreatedAfter  <DateTime>]
[-CreatedBefore  <DateTime>]
[-Name  <String[]>]
[-Newest]
[-SoftwareDepot  <SoftwareDepot[]>]
[-Tag  <String[]>]
[-Vendor  <String[]>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
optional
Version
String[] 1 Filters the output to list only VIBs whose Version field matches one of the strings supplied. Wildcard characters are supported.
optional
AcceptanceLevel
AcceptanceLevels[] named 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
optional
CreatedAfter
DateTime named 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.
optional
CreatedBefore
DateTime named 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.
optional
Name
String[] named Filters the output to list only VIBs whose Name field matches one of the strings supplied. Wildcard characters are supported.
optional
Newest
SwitchParameter named 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".
optional
SoftwareDepot
SoftwareDepot[] named
  • pipeline
  • optional
    Tag
    String[] named Filters the output to list only VIBs whose Tag field matches one of the strings supplied. Wildcard characters are supported.
    optional
    Vendor
    String[] named Filters the output to list only VIBs whose Vendor field matches one of the strings supplied. Wildcard characters are supported.

    [-PackageUrl  <String[]>]
    [CommonParameters]

    Parameters

    Required Parameter Name Type Position Features Description
    optional
    PackageUrl
    String[] named Loads packages from package (.vib) files.

    Output

    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:

    Feedback

    Was this page helpful?