Save-Module

Module:

PowerShellGet Module

Saves a module and its dependencies on the local computer but doesn't install the module.

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

Save-Module
 [-Name] <String[]>
 -LiteralPath <String>
 [-MinimumVersion <String>]
 [-MaximumVersion <String>]
 [-RequiredVersion <String>]
 [-Repository <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>]

The Save-Module cmdlet downloads a module and any dependencies from a registered repository. Save-Module downloads and saves the most current version of a module. The files are saved to a specified path on the local computer. The module isn't installed, but the contents are available for inspection by an administrator. The saved module can then be copied into the appropriate $env:PSModulePath location of the offline machine.

Get-PSRepository displays the local computer's registered repositories. You can use the Find-Module cmdlet to search registered repositories.

The parameters that take module version numbers expect strings formatted as version numbers.

• Standard version numbers have a format of x.y.z where x, y, and z are numbers
• Prerelease versions have a format of x.y.z-<prerelease_label> where the <prerelease_label> is arbitrary string assigned to that release.

In this example, a module and its dependencies are saved to the local computer.

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 uses the Name parameter to specify the module, PowerShellGet. The Path parameter specifies where to store the downloaded module. The Repository parameter specifies a registered repository, PSGallery. After the download is finished, Get-ChildItem displays the contents of Path where the files are stored.

This example shows how to use a parameter such as MaximumVersion, or RequiredVersion to specify a module version.

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 uses the Name parameter to specify the module, PowerShellGet. The Path parameter specifies where to store the downloaded module. The Repository parameter specifies a registered repository, PSGallery. MaximumVersion specifies that version 2.1.0 is downloaded and saved. After the download is finished, Get-ChildItem displays the contents of Path where the files are stored.

In this example, a required module version is found in the repository and saved to the local computer.

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 uses the Name parameter to specify the module, PowerShellGet. The Repository parameter specifies a registered repository, PSGallery. RequiredVersion specifies version 1.6.5.

The object is sent down the pipeline to Save-Module. The Path parameter specifies where to store the downloaded module. After the download is finished, Get-ChildItem displays the contents of Path where the files are stored.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.