Install-Package

语法

PackageBySearch （默认值）

Install-Package
    [-Name] <String[]>
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ProviderName <String[]>]
    [<CommonParameters>]

PackageByInputObject

Install-Package
    [-InputObject] <SoftwareIdentity[]>
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NuGet:PackageBySearch

Install-Package
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

NuGet:PackageByInputObject

Install-Package
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

PowerShellGet:PackageBySearch

Install-Package
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-AllowPrereleaseVersions]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [<CommonParameters>]

PowerShellGet:PackageByInputObject

Install-Package
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-AllowPrereleaseVersions]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [<CommonParameters>]

说明

示例

Example 1: Install a package by package name

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Example 2: Use Find-Package to install a package

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Example 3: Install packages by specifying a range of versions

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

参数

-AcceptLicense

AcceptLicense automatically accepts the license agreement during installation.

参数属性

参数集

-AllowClobber

Overrides warning messages about conflicts with existing commands. Overwrites existing commands that have the same name as commands being installed.

参数属性

参数集

-AllowPrereleaseVersions

Allows the installation of packages marked as prerelease.

参数属性

参数集

-AllVersions

Install-Package installs all available versions of the package. By default, only the newest version is installed.

参数属性

参数集

-Command

Specifies one or more commands that Install-Package searches.

参数属性

参数集

-ConfigFile

Specifies a path that contains a configuration file.

参数属性

参数集

-Confirm

Prompts you for confirmation before running the cmdlet.

参数属性

参数集

-Contains

Install-Package gets objects if the Contains parameter specifies a value that matches any of the object's property values.

参数属性

参数集

-Credential

Specifies a user account that has permission to access the computer and run commands. Type a user name, such as User01, Domain01\User01, or enter a PSCredential object, generated by the Get-Credential cmdlet. If you type a user name, you're prompted for a password.

When the Credential parameter isn't specified, Install-Package uses the current user.

参数属性

参数集

-Destination

Specifies a path to an input object.

参数属性

参数集

-DscResource

Specifies one or more Desired State Configuration (DSC) resources that are searched by Install-Package. Use the Find-DscResource cmdlet to find DSC resources.

参数属性

参数集

-ExcludeVersion

Switch to exclude the version number in the folder path.

参数属性

参数集

-Filter

Specifies terms to search for within the Name and Description properties.

参数属性

参数集

-FilterOnTag

Specifies a tag that filters results and excludes results that don't contain the specified tag.

参数属性

参数集

-Force

Forces the command to run without asking for user confirmation. Overrides restrictions that prevent Install-Package from succeeding, with the exception of security.

参数属性

参数集

-ForceBootstrap

Forces PackageManagement to automatically install the package provider for the specified package.

参数属性

参数集

-Headers

Specifies the package headers.

参数属性

参数集

-Includes

Specifies whether Install-Package should find all package types. The acceptable values for this parameter are as follows:

• Cmdlet
• DscResource
• Function
• RoleCapability
• Workflow

参数属性

参数集

-InputObject

Accepts pipeline input. Specifies a package by using the package's SoftwareIdentity type. Find-Package outputs a SoftwareIdentity object.

参数属性

参数集

-InstallUpdate

Indicates that Install-Package installs updates.

参数属性

参数集

-MaximumVersion

Specifies the maximum allowed package version that you want to install. If you don't specify this parameter, Install-Package installs the package's newest version.

参数属性

参数集

-MinimumVersion

Specifies the minimum allowed package version that you want to install. If you don't add this parameter, Install-Package installs the package's newest version that satisfies any version specified by the MaximumVersion parameter.

参数属性

参数集

-Name

Specifies one or more package names. Multiple package names must be separated by commas.

参数属性

参数集

-NoPathUpdate

NoPathUpdate only applies to the Install-Script cmdlet. NoPathUpdate is a dynamic parameter added by the provider and isn't supported by Install-Package.

参数属性

参数集

-PackageManagementProvider

Specifies the name of the PackageManagement provider.

参数属性

参数集

-ProviderName

Specifies one or more package provider names to which to scope your package search. You can get package provider names by running the Get-PackageProvider cmdlet.

参数属性

参数集

-Proxy

Specifies a proxy server for the request, rather than connecting directly to an internet resource.

参数属性

参数集

-ProxyCredential

Specifies a user account that has permission to use the proxy server specified by the Proxy parameter.

参数属性

参数集

-PublishLocation

Specifies the path to a package's published location.

参数属性

参数集

-RequiredVersion

Specifies the exact allowed version of the package that you want to install. If you don't add this parameter, Install-Package installs the package's newest version that satisfies any version specified by the MaximumVersion parameter.

参数属性

参数集

-RoleCapability

Specifies an array of role capabilities.

参数属性

参数集

-Scope

Specifies the scope for which to install the package. The acceptable values for this parameter are as follows:

• CurrentUser
• AllUsers

参数属性

参数集

-ScriptPublishLocation

Specifies the path to a script's published location.

参数属性

参数集

-ScriptSourceLocation

Specifies the script source location.

参数属性

参数集

-SkipDependencies

Skips the installation of software dependencies.

参数属性

参数集

-SkipPublisherCheck

Allows you to get a package version that is newer than your installed version. For example, an installed package that is digitally signed by a trusted publisher but a new version isn't digitally signed.

参数属性

参数集

-SkipValidate

Switch that skips validating the credentials of a package.

参数属性

参数集

-Source

Specifies one or more package sources. Multiple package source names must be separated by commas. You can get package source names by running the Get-PackageSource cmdlet.

参数属性

参数集

-Tag

Specifies one or more strings to search for in the package metadata.

参数属性

参数集

-Type

Specifies whether to search for packages with a module, a script, or both. The acceptable values for this parameter are as follows:

• Module
• Script
• All

参数属性

参数集

-WhatIf

Shows what would happen if Install-Package cmdlet is run. The cmdlet is not run.

参数属性

参数集

CommonParameters

输入

输出

备注

相关链接

• about_PackageManagement
• Find-DscResource
• Get-Help
• Get-Package
• Get-PackageProvider
• Get-PackageSource
• Find-Package
• Save-Package
• Uninstall-Package