Поделиться через


Save-Module

Сохраняет модуль и его зависимости на локальном компьютере, но не устанавливает модуль.

Синтаксис

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

Описание

Командлет Save-Module скачивает модуль и все зависимости из зарегистрированного репозитория. Save-Module загружает и сохраняет самую последнюю версию модуля. Файлы сохраняются по указанному пути на локальном компьютере. Модуль не установлен, но его содержимое доступно для проверки администратором. Затем сохраненный модуль можно скопировать в соответствующее $env:PSModulePath расположение автономного компьютера.

Это прокси-командлет для командлета Save-PSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе 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

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Save-PSResource.

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

-AllowPrerelease

Позволяет сохранить модуль, помеченный как предварительный выпуск.

Командлет прокси-сервера сопоставляет этот параметр с параметром prerelease объекта 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

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается 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 используется точно так, как указано. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите их в одинарные кавычки. PowerShell не интерпретирует символы, заключенные в одинарные кавычки, как escape-последовательности.

Командлет прокси-сервера сопоставляет этот параметр с параметром Path объекта Save-PSResource.

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

-MaximumVersion

Командлет прокси-сервера использует значение этого параметра для создания строки поиска версии NuGet для использования с параметром Version .Save-PSResource

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

-MinimumVersion

Командлет прокси-сервера использует значение этого параметра для создания строки поиска версии NuGet для использования с параметром Version .Save-PSResource

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

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Save-PSResource.

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

-ProxyCredential

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается 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

Командлет прокси-сервера использует значение этого параметра для создания строки поиска версии NuGet для использования с параметром Version .Save-PSResource

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

-WhatIf

Показывает, что произойдет при выполнении Save-Module . Командлет не выполняется.

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