Save-Module

參考

模組:: PowerShellGet

將模組及其相依性儲存在本機計算機上，但不會安裝模組。

Syntax

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

Description

Cmdlet Save-Module 會從已註冊的存放庫下載模組和任何相依性。 Save-Module 會下載並儲存模組的最新版本。檔案會儲存至本機電腦上的指定路徑。模組未安裝，但內容可供系統管理員檢查。然後，可以將儲存的模組複製到離線電腦的適當 $env:PSModulePath 位置。

Get-PSRepository 會顯示本機計算機的已註冊存放庫。您可以使用 Find-Module Cmdlet 來搜尋已註冊的存放庫。

範例

範例 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 會顯示儲存盤案之 Path 的內容。

範例 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 會顯示儲存盤案之 Path 的內容。

範例 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 會顯示儲存盤案之 Path 的內容。

參數

-AcceptLicense

如果套件需要，則自動接受許可協定。

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

-AllowPrerelease

可讓您儲存標示為發行前版本的模組。

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

Save-Module強制執行而不要求用戶確認。

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 不會將以單引弧括住的任何字元解譯為逸出序列。

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

-MaximumVersion

指定要儲存之模組的最大值或最新版本。 MaximumVersion 和 RequiredVersion 參數不能用在相同的命令中。

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

-MinimumVersion

指定要儲存的單一模組最低版本。如果您嘗試安裝多個模組，則無法新增此參數。 MinimumVersion 和 RequiredVersion 參數不能用於相同的命令。

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

指定要求的 Proxy 伺服器，而不是直接連線到因特網資源。

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

-ProxyCredential

指定具有使用 Proxy 參數所指定 Proxy 伺服器之權限的使用者帳戶。

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

指定要儲存之模組的確切版本號碼。

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

備註

重要

從 2020 年 4 月起，PowerShell 資源庫已不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。如果您不是使用 TLS 1.2 或更高版本，您在嘗試存取 PowerShell 資源庫時將會收到錯誤。使用下列命令來確保您使用的是 TLS 1.2：

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

如需詳細資訊，請參閱 PowerShell 部落格中的公告 $英文$。

共用方式為