Find-Package

Syntax

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [<CommonParameters>]

Description

The Find-Package cmdlet finds matching software packages that are available in package sources.

Examples

Example 1: Find all available packages from a package provider

PS C:\> Find-Package -Provider "PSModule"

This command finds all available Windows PowerShell module packages from galleries that are registered with the PSModule provider.

Example 2: Find a package from a provider that is not yet installed

PS C:\> Find-Package -Name "Git" -Provider "Chocolatey"

This command first automatically installs the Chocolatey provider on the local computer, then searches for the Git package within that provider.

Example 3: Find a package from a package source

PS C:\> Find-Package -Name "Git" -Source "ChocolateyRepository"

This command finds a package from a specified package source. This is a useful command if you know the name of the package source that you want to search, but are unsure about the package provider to which the source is registered. Without specifying a package source, Find-Package searches through all installed package providers and their package sources for a specified package. You can run Get-PackageSource -Location to get a package source name.

Example 4: Find a package from a file system

PS C:\> Find-Package "C:\temp"

This command finds packages from all installed PackageManagement package providers that are stored in the C:\temp folder on the local computer.

Example 5: Find a package with a specific name and version

PS C:\> Find-Package -Name "DSCAccel" -RequiredVersion "2.1.2"

This command finds version 2.1.2 of a package named DSCAccelerator. Although only part of the package name has been specified, Find-Package should be able to find the DSCAccelerator package if there are no other packages with a name matching that pattern.

Example 6: Find packages within a range of versions

PS C:\> Find-Package -Name "DSCAccelerator" -MinimumVersion "1.5.0" -MaximumVersion "2.1" -AllVersions

This command finds a matching range of versions of a package named DSCAccelerator, by adding the MinimumVersion and MaximumVersion parameters to specify a range, and the AllVersions parameter to specify that all matching results within that range are returned as results.

Optional Parameters

Inputs

None

You cannot pipe input to this cmdlet

Outputs

SoftwareIdentify[]

This cmdlet does not produce any output.

Related Links

• about_PackageManagement
• Get-Package
• Install-Package
• Save-Package
• Uninstall-Package