Save-PSResource

将已注册存储库中的资源(模块和脚本)保存到计算机。

语法

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-PSResource
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-InputObject] <PSResourceInfo[]>
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

此 cmdlet 结合了 PowerShellGet v2 中 Save-ModuleSave-Script cmdlet 的功能。 Save-PSResource 将资源从已注册的存储库下载到本地计算机上的特定路径。 默认情况下,资源以解压缩或已安装的格式保存。 脚本或模块可以从保存的位置运行。 还可以选择以 .nupkg 格式下载资源。

示例

示例 1

从最高优先级存储库下载 Az 模块,并将其保存到当前位置。

Save-PSResource -Name Az

示例 2

从 PowerShell 库下载 Az 模块,并将其保存到当前位置。

Save-PSResource -Name Az -Repository PSGallery

示例 3

从最高优先级存储库下载 Az 模块,并将其 .nupkg 格式保存到当前位置。

Save-PSResource Az -AsNupkg

示例 4

从最高优先级存储库下载 Az 模块,并包括 PowerShellGet XML 元数据文件。

Save-PSResource Az -IncludeXML

参数

-AcceptLicense

对于需要许可证的模块,在安装过程中自动接受许可协议。

此参数已在 PSResourceGet 1.1.0-rc1 中添加。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-AsNupkg

将资源另存为 .nupkg 文件。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-AuthenticodeCheck

验证 Windows 上资源的已签名文件和目录文件。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Credential

访问存储库时使用的可选凭据。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IncludeXml

包括用于验证 PowerShellGet 是否已安装模块的 PowerShellGet 元数据 XML。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-InputObject

用于管道输入。

类型:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
别名:ParentResource
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

要安装的一个或多个资源的名称。

类型:String[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PassThru

指定后,输出已保存资源的 PSResourceInfo 对象。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Path

指定要将资源保存到的路径。 如果未提供路径,资源将保存在当前目录中。

类型:String
Position:Named
默认值:current directory
必需:False
接受管道输入:False
接受通配符:False

-Prerelease

指定后,在返回的搜索结果中包含预发行版版本。

类型:SwitchParameter
别名:IsPrerelease
Position:Named
默认值:False
必需:False
接受管道输入:True
接受通配符:False

-Quiet

取消进度栏输出。

此参数已在 PSResourceGet 1.1.0-rc1 中添加。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Repository

指定要搜索的一个或多个存储库名称。 如果未指定,搜索将按优先级顺序(最高第一个)包括所有已注册的存储库,直到找到包含包的存储库。 存储库按优先级排序,然后按名称排序。 较低 优先级 值具有更高的优先级。

跨多个存储库搜索资源时,PSResourceGet cmdlet 使用此排序顺序搜索存储库。 Save-PSResource 保存存储库排序列表中的第一个匹配包。

该参数支持 * 通配符。 如果指定多个存储库,则所有名称都必须包含或省略通配符。 不能使用通配符和不使用通配符指定名称的组合。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-SkipDependencyCheck

跳过资源依赖项的检查。 仅安装找到的资源。 未安装找到的资源。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-TemporaryPath

指定在保存之前临时安装资源的路径。 如果未提供临时路径,资源将临时安装在当前用户的临时文件夹中。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrustRepository

禁止提示信任存储库。 仅当存储库未配置为受信任时,才会出现信任存储库提示。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Version

指定要返回的资源的版本。 该值可以是使用 NuGet 版本控制语法的确切版本或版本范围。

有关 NuGet 版本范围的详细信息,请参阅 包版本控制

PowerShellGet 支持 NuGet 版本范围文档中列出的所有 最低非独占版本。 使用 1.0.0.0,因为版本不会生成版本 1.0.0.0 及更高版本(最低非独占范围)。 相反,该值被视为所需的版本。 若要搜索最小非独占范围,请使用 [1.0.0.0, ] 作为版本范围。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-WhatIf

显示 cmdlet 运行时会发生什么情况。 该 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

输出

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

默认情况下,cmdlet 不返回任何对象。 使用 PassThru 参数时,该 cmdlet 会输出已保存资源的 PSResourceInfo 对象。