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 расположение автономного компьютера.

Get-PSRepository отображает зарегистрированные репозитории локального компьютера. Командлет можно использовать для Find-Module поиска зарегистрированных репозиториев.

Примеры

Пример 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 указывает место хранения скачаемого модуля. Параметр репозитория указывает зарегистрированный репозиторий 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 указывает место хранения скачаемого модуля. Параметр репозитория указывает зарегистрированный репозиторий 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. Параметр репозитория указывает зарегистрированный репозиторий PSGallery. RequiredVersion указывает версию 1.6.5.

Объект отправляется по конвейеру.Save-Module Параметр Path указывает место хранения скачаемого модуля. После завершения скачивания отобразится содержимое пути, Get-ChildItem в котором хранятся файлы.

Параметры

-AcceptLicense

Автоматически примите лицензионное соглашение, если пакет требует его.

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

-AllowPrerelease

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

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

-Confirm

Запрашивает подтверждение перед запуском Save-Module.

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

-Credential

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

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

-Force

Если расположение, указанное параметром Path , не существует, командлет возвращает ошибку. С помощью параметра Force создается целевой путь.

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

-InputObject

Принимает объект PSRepositoryItemInfo . Например, вывод Find-Module в переменную и использование этой переменной в качестве аргумента InputObject .

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

-LiteralPath

Указывает путь к одному или нескольким расположениям. Значение параметра LiteralPath используется точно так же, как введено. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите их в одинарные кавычки. PowerShell не интерпретирует символы, заключенные в одинарные кавычки, как escape-последовательности.

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

-MaximumVersion

Указывает максимальную или последнюю версию модуля для сохранения. Параметры MaximumVersion и RequiredVersion нельзя использовать в одной команде.

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

-MinimumVersion

Указывает минимальную версию одного модуля для сохранения. Этот параметр нельзя добавить, если вы пытаетесь установить несколько модулей. Параметры MinimumVersion и RequiredVersion нельзя использовать в одной команде.

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

-Name

Задает массив имен модулей для сохранения.

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

-Path

Указывает расположение на локальном компьютере для хранения сохраненного модуля. Принимает подстановочные знаки.

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

-Proxy

Указывает прокси-сервер для запроса, а не подключение непосредственно к интернет-ресурсу.

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

-ProxyCredential

Указывает учетную запись пользователя, имеющую разрешение на использование прокси-сервера, который задается параметром Proxy.

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

-Repository

Указывает понятное имя репозитория, зарегистрированного при выполнении Register-PSRepository. Используется для Get-PSRepository отображения зарегистрированных репозиториев.

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

-RequiredVersion

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

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

-WhatIf

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

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

Входные данные

String[]

PSObject[]

String

Uri

PSCredential

Выходные данные

Object

Примечания

Важно!

Начиная с апреля 2020 года коллекция PowerShell не поддерживает протокол TLS (Transport Layer Security) версий 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке доступа к коллекции PowerShell возникнет ошибка. Чтобы проверить, используется ли TLS 1.2, выполните следующую команду:

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

Дополнительные сведения см. в объявлении в блоге, посвященном PowerShell.