Save-Module

参考

模块:: PowerShellGet

在本地计算机上保存模块及其依赖项，但不安装该模块。

语法

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

cmdlet Save-Module 从已注册的存储库下载模块和任何依赖项。 Save-Module 下载并保存模块的最新版本。这些文件将保存到本地计算机上的指定路径。模块未安装，但内容可供管理员检查。然后，可以将保存的模块复制到脱机计算机的相应 $env:PSModulePath 位置。

这是 Microsoft.PowerShell.PSResourceGet 中 cmdlet 的代理 Save-PSResource cmdlet。有关详细信息，请参阅 Save-PSResource

示例

示例 1：保存模块

在此示例中，模块及其依赖项保存到本地计算机。

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

Save-Module 使用 Name 参数指定模块 PowerShellGet。 Path 参数指定存储下载的模块的位置。 Repository 参数指定注册的存储库 PSGallery。下载完成后， Get-ChildItem 显示存储文件 的路径 的内容。

示例 2：保存模块的特定版本

此示例演示如何使用 MaximumVersion 或 RequiredVersion 等参数来指定模块版本。

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

Save-Module 使用 Name 参数指定模块 PowerShellGet。 Path 参数指定存储下载的模块的位置。 Repository 参数指定注册的存储库 PSGallery。 MaximumVersion 指定下载并保存版本 2.1.0 。下载完成后， Get-ChildItem 显示存储文件 的路径 的内容。

示例 3：查找并保存模块的特定版本

在此示例中，在存储库中找到所需的模块版本，并保存到本地计算机。

Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

Find-Module 使用 Name 参数指定模块 PowerShellGet。 Repository 参数指定注册的存储库 PSGallery。 RequiredVersion 指定版本 1.6.5。

对象在管道 Save-Module中向下发送到。 Path 参数指定存储下载的模块的位置。下载完成后， Get-ChildItem 显示存储文件 的路径 的内容。

参数

-AcceptLicense

代理 cmdlet 会忽略此参数，因为它不受支持 Save-PSResource。

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

-AllowPrerelease

允许保存标记为预发行的模块。

代理 cmdlet 将此参数映射到的Save-PSResource预发布参数。

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

-Confirm

在运行 Save-Module之前，会提示你进行确认。

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:	True
Accept wildcard characters:	False

-Force

代理 cmdlet 会忽略此参数，因为它不受支持 Save-PSResource。

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

-InputObject

接受 PSRepositoryItemInfo 对象。例如，输出 Find-Module 到变量，并将该变量用作 InputObject 参数。

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

-LiteralPath

指定一个或多个位置的路径。 LiteralPath 参数的值完全按照输入的方式使用。不会将任何字符解释为通配符。如果路径包含转义字符，请用单引号将它们括起来。 PowerShell 不会将任何用单引号括起来的字符解释为转义序列。

代理 cmdlet 将此参数映射到的 Save-PSResourcePath 参数。

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

-MaximumVersion

代理 cmdlet 使用此参数的值来创建 NuGet 版本搜索字符串，以便与的Save-PSResourceVersion 参数一起使用。

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

-MinimumVersion

代理 cmdlet 使用此参数的值来创建 NuGet 版本搜索字符串，以便与的Save-PSResourceVersion 参数一起使用。

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-Path

指定用于存储已保存模块的本地计算机上的位置。接受通配符。

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

-Proxy

代理 cmdlet 会忽略此参数，因为它不受支持 Save-PSResource。

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

-ProxyCredential

代理 cmdlet 会忽略此参数，因为它不受支持 Save-PSResource。

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

-Repository

指定已通过运行 Register-PSRepository注册的存储库的友好名称。使用 Get-PSRepository 显示已注册的存储库。

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

-RequiredVersion

代理 cmdlet 使用此参数的值来创建 NuGet 版本搜索字符串，以便与的Save-PSResourceVersion 参数一起使用。

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

-WhatIf

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

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

输入

String[]

PSObject[]

String

Uri

PSCredential

输出

Object

备注

PowerShell 库不再支持传输层安全性 (TLS) 版本 1.0 和 1.1。必须使用 TLS 1.2 或更高版本。使用以下命令可以确定使用的是 TLS 1.2：

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

Share via

Save-Module

语法

说明

示例

示例 1：保存模块

示例 2：保存模块的特定版本

示例 3：查找并保存模块的特定版本

参数

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-LiteralPath

-MaximumVersion

-MinimumVersion

-Name

-Path

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-WhatIf

输入

输出

备注

反馈

其他资源