Save-Package

模块:: PackageManagement Module

将包保存到本地计算机，而无需安装它们。

语法

PackageBySearch

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

PackageByInputObject

Save-Package
    -InputObject <SoftwareIdentity>
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NuGet:PackageByInputObject

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

NuGet

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

PowerShellGet:PackageByInputObject

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

PowerShellGet

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

说明

Save-Package cmdlet 将包保存到本地计算机，但不安装包。除非指定 RequiredVerion，否则此 cmdlet 将保存包的最新版本。 Path 和 LiteralPath 参数互斥，不能添加到同一命令。

示例

示例 1：将包保存到本地计算机

此示例将包的最新版本保存到本地计算机上的目录。包的依赖项随包一起下载。

PS> Save-Package -Name NuGet.Core -ProviderName NuGet -Path C:\LocalPkg

Name                    Version    Source    Summary
----                    -------    ------    -------
Microsoft.Web.Xdt       3.0.0      Nuget     Microsoft Xml Document Transformation (XDT) enables...
NuGet.Core              2.14.0     Nuget     NuGet.Core is the core framework assembly for NuGet...

Save-Package 使用 Name 参数来指定包。包是从 ProviderName 参数指定的存储库下载的。 Path 参数确定包的保存位置。

示例 2：保存特定包版本

此示例指定包版本并将其保存到本地计算机上的目录。

PS> Save-Package -Name NuGet.Core -RequiredVersion 2.9.0 -ProviderName NuGet -Path C:\LocalPkg

Name                    Version    Source    Summary
----                    -------    ------    -------
Microsoft.Web.Xdt       3.0.0      Nuget     Microsoft Xml Document Transformation (XDT) enables...
NuGet.Core              2.9.0      Nuget     NuGet.Core is the core framework assembly for NuGet...

Save-Package 使用 Name 参数来指定包。 RequiredVersion 指示特定的包版本。包是从 ProviderName 参数指定的存储库下载的。 Path 参数确定包的保存位置。

示例 3：使用 Find-Package 保存包

此命令使用 Find-Package 查找最新版本的包，并将对象发送到 Save-Package。

PS> Find-Package -Name NuGet.Core -ProviderName NuGet | Save-Package -Path C:\LocalPkg

Find-Package 使用 Name 参数来指定包。包是从 ProviderName 参数指定的存储库下载的。将对象向下发送到管道 Save-Package。 Path 参数确定包的保存位置。

示例 4：保存并安装包

最新版本的包及其依赖项将下载并安装在本地计算机上。

PS> Save-Package -Name NuGet.Core -ProviderName NuGet -Path C:\LocalPkg
PS> Install-Package C:\LocalPkg\NuGet.Core.2.14.0.nupkg

Save-Package 将包文件及其依赖项下载到本地计算机。 Install-Package 从指定目录安装包和依赖项。

参数

-AcceptLicense

如果程序包需要，则自动接受安装期间的许可协议。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AllowPrereleaseVersions

允许保存标记为预发行版的包。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

NuGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

NuGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AllVersions

指示此 cmdlet 保存包的所有可用版本。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Command

指定包中包含的一个或多个命令。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConfigFile

指定配置文件。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

NuGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

NuGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Contains

Save-Package 如果对象的属性值中的任何项与指定值完全匹配，则获取对象。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

NuGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

NuGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Credential

指定有权从指定的包提供程序或源保存包的用户帐户。

参数属性

类型:	PSCredential
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DscResource

指定包的一个或多个 Desired State Configuration （DSC）资源。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Filter

指定包的筛选器。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-FilterOnTag

指定筛选结果的标记。不包括不包含指定标记的结果。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

NuGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

NuGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Force

强制命令运行而不要求用户确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ForceBootstrap

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Headers

指定包的标头。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

NuGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

NuGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Includes

指示包包含的资源。

参数属性

类型:	String[]
默认值:	None
接受的值:	DscResource, Cmdlet, Function, Workflow, RoleCapability
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

表示要保存的包的软件 ID 对象。软件 ID 是 Find-Package cmdlet 结果的一部分。

参数属性

类型:	Microsoft.PackageManagement.Packaging.SoftwareIdentity
默认值:	None
支持通配符:	False
不显示:	False

参数集

PackageByInputObject

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-LiteralPath

指定要将包保存到的文本路径。不能同时将此参数和 Path 参数添加到同一命令。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MaximumVersion

指定要保存的包的最大版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PackageBySearch

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MinimumVersion

指定要查找的包的最低版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PackageBySearch

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

指定一个或多个包名称。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

PackageBySearch

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PackageManagementProvider

指定包管理提供程序。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Path

指定要存储包的本地计算机上的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ProviderName

指定一个或多个提供程序名称。

参数属性

类型:	String[]
默认值:	None
接受的值:	Bootstrap, NuGet, PowerShellGet
支持通配符:	False
不显示:	False
别名:	提供者

参数集

PackageBySearch

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Proxy

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

参数属性

类型:	Uri
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ProxyCredential

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

参数属性

类型:	PSCredential
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PublishLocation

指定发布位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RequiredVersion

指定要保存的包的确切版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PackageBySearch

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RoleCapability

指定角色功能的数组。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ScriptPublishLocation

指定脚本发布位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ScriptSourceLocation

指定脚本源位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SkipValidate

跳过验证包凭据的开关。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

NuGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

NuGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Source

指定一个或多个包源。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

PackageBySearch

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Tag

指定要在包元数据中搜索的标记。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Type

指定是搜索包含模块、脚本的包，还是搜索包。

参数属性

类型:	String
默认值:	None
接受的值:	Module, Script, All
支持通配符:	False
不显示:	False

参数集

PowerShellGet:PackageByInputObject

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

PowerShellGet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

输入

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

输出

None

此 cmdlet 不返回任何输出。

备注

重要

截至 2020 年 4 月，PowerShell 库不再支持传输层安全性（TLS）版本 1.0 和 1.1。如果未使用 TLS 1.2 或更高版本，则尝试访问 PowerShell 库时会收到错误。使用以下命令确保使用的是 TLS 1.2：

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

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

反馈

此页面是否有帮助？