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

Описание

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

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

Параметры, которые принимают номера версий модуля, ожидают строк, отформатированных в виде номеров версий.

Номера стандартных версий имеют формат x.y.z , где x, y и z — числа.
Предварительные версии имеют формат , в котором <prerelease_label> является произвольной x.y.z-<prerelease_label> строкой, назначенной для этого выпуска.

Примеры

Пример 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

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

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.