Save-PSResource

参考

模块:: Microsoft.PowerShell.PSResourceGet

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

语法

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-Script cmdlet 的功能Save-Module。 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

参数

-AsNupkg

将资源另存为 .nupkg 文件。

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

-AuthenticodeCheck

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

Type:	SwitchParameter
Position:	Named
Default value:	False
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

-Credential

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

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

-IncludeXml

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

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

-InputObject

用于管道输入。

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:	ParentResource
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

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

-PassThru

指定后，为保存的资源输出 PSResourceInfo 对象。

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

-Path

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

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

-Prerelease

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

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

-Repository

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

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

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

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

-SkipDependencyCheck

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

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

-TemporaryPath

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

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

-TrustRepository

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

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

-Version

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

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

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

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

-WhatIf

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

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

输入

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

输出

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

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

通过