Install-Package

模块:

PackageManagement

安装一个或多个软件包。

语法

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>]

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

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>]

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>]

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>]

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>]

说明

cmdlet Install-Package 在本地计算机上安装一个或多个软件包。 如果有多个软件源，请使用 Get-PackageProvider 和 Get-PackageSource 显示有关提供商的详细信息。

重要

PackageManagement 模块中包含的命令不同于 Visual Studio 的包管理器控制台中 NuGet 模块提供的命令。 每个模块都有在其他模块中不可用的命令。 具有相同名称的命令在其特定参数上有所不同。 有关详细信息，请参阅 Visual Studio 的包管理器控制台的 PowerShell 参考 文档。

示例

示例 1：按包名称安装包

cmdlet Install-Package 安装软件包及其依赖项。

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

Install-Package 使用参数指定包 Name 和 Source。 Credential 参数使用具有安装包权限的域用户帐户。 命令会提示输入用户帐户密码。

示例 2：使用 Find-Package 安装包

在此示例中，返回 Find-Package 的对象在管道中向下发送，并由 Install-Package安装。

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

Find-Package 使用 Name 和 Source 参数查找包。 对象在管道中向下发送，并将 Install-Package 包安装在本地计算机上。

示例 3：通过指定版本范围安装包

Install-Package 使用 MinimumVersion 和 MaximumVersion 参数指定一系列软件版本。

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

Install-Package 使用 Name 和 Source 参数查找包。 MinimumVersion 和 MaximumVersion 参数指定一系列软件版本。 已安装该范围中的最高版本。

参数

-AcceptLicense

AcceptLicense 在安装期间自动接受许可协议。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowClobber

替代有关与现有命令冲突的警告消息。 覆盖与所安装的命令同名的现有命令。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrereleaseVersions

允许安装标记为预发行版的包。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllVersions

Install-Package 安装包的所有可用版本。 默认情况下，仅安装最新版本。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

指定搜索的 Install-Package 一个或多个命令。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFile

指定包含配置文件的路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Contains

Install-Package 如果 Contains 参数指定的值与对象的任何属性值匹配，则获取 对象。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

指定有权访问计算机和运行命令的用户帐户。 键入用户名（如 User01、Domain01\User01），或输入 cmdlet Get-Credential 生成的 PSCredential 对象。 如果键入用户名，系统会提示输入密码。

如果未指定 Credential 参数， Install-Package 则 使用当前用户。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

指定输入对象的路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DscResource

指定由 Install-Package搜索的一个或多个Desired State Configuration (DSC) 资源。 使用 Find-DscResource cmdlet 查找 DSC 资源。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeVersion

切换以排除文件夹路径中的版本号。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

指定在 Name 和 Description 属性中要搜索的术语。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilterOnTag

指定筛选结果并排除不包含指定标记的结果的标记。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

强制运行命令而不要求用户确认。 替代阻止 Install-Package 成功的限制，但安全性除外。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceBootstrap

强制 PackageManagement 自动安装指定包的包提供程序。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Headers

指定包标头。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Includes

指定是否 Install-Package 应查找所有包类型。 此参数的可接受值如下所示：

• Cmdlet
• DscResource
• 功能
• RoleCapability
• 工作流

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

接受管道输入。 使用包的 SoftwareIdentity 类型指定包。 Find-Package 输出 SoftwareIdentity 对象。

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

指示 Install-Package 安装更新。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

指定要安装的最大允许包版本。 如果未指定此参数， Install-Package 则安装包的最新版本。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumVersion

指定要安装的允许的最低包版本。 如果不添加此参数， Install-Package 将安装包的最新版本，该版本满足 MaximumVersion 参数指定的任何版本。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定一个或多个包名称。 多个包名称必须用逗号分隔。

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoPathUpdate

NoPathUpdate 仅适用于 Install-Script cmdlet。 NoPathUpdate 是由提供程序添加的动态参数，不受 支持 Install-Package。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageManagementProvider

指定 PackageManagement 提供程序的名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProviderName

指定一个或多个将用作包搜索限定范围的包提供程序名称。 可运行 Get-PackageProvider cmdlet 来获取包提供程序名称。

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

为请求指定代理服务器，而不是直接连接到 Internet 资源。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProxyCredential

指定有权使用 Proxy 参数指定的代理服务器的用户帐户。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublishLocation

指定包的已发布位置的路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredVersion

指定要安装的包的确切允许版本。 如果不添加此参数， Install-Package 将安装包的最新版本，该版本满足 MaximumVersion 参数指定的任何版本。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleCapability

指定角色功能的数组。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

指定要为其安装包的范围。 此参数的可接受值如下所示：

• CurrentUser
• AllUsers

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

指定脚本的已发布位置的路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptSourceLocation

指定脚本源位置。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencies

跳过软件依赖项的安装。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipPublisherCheck

允许获取比已安装版本更新的包版本。 例如，已安装的包由受信任的发布者进行数字签名，但新版本未进行数字签名。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidate

跳过验证包凭据的开关。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

指定一个或多个包源。 必须用逗号分隔多个包源。 可以通过运行 Get-PackageSource cmdlet 获取包源名称。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

指定要在包元数据中搜索的一个或多个字符串。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

指定是使用模块和/或脚本搜索包。 此参数的可接受值如下所示：

• 模块
• Script
• 全部

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示运行 cmdlet 时 Install-Package 会发生什么情况。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.PackageManagement.Packaging.SoftwareIdentity

可以通过管道将 SoftwareIdentity 对象传递给此 cmdlet。

输出

Microsoft.PackageManagement.Packaging.SoftwareIdentity

此 cmdlet 为其安装的每个包返回 一个 SoftwareIdentity 对象。

备注

在命令中包含包提供程序可以使动态参数可用于 cmdlet。 动态参数特定于包提供程序。 该 Get-Help cmdlet 列出 cmdlet 的参数集，并包含提供程序的参数集。 例如， Install-Package 具有包含 -NoPathUpdate、 AllowClobber和 SkipPublisherCheck的 PowerShellGet 参数集。

重要

自 2020 年 4 月起，PowerShell 库已不再支持传输层安全性 (TLS) 版本 1.0 和 1.1。 如果你使用的不是 TLS 1.2 或更高版本，那么，在尝试访问 PowerShell 库时，将会收到错误。 使用以下命令可以确定使用的是 TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

有关详细信息，请参阅 PowerShell 博客中的公告。

相关链接

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