Save-Module

Модуль:

PowerShellGet Module

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

Синтаксис

NameAndPathParameterSet (По умолчанию)

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

NameAndLiteralPathParameterSet

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

InputObjectAndLiteralPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndPathParameterSet

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 являются числами
• Предварительные версии имеют формат x.y.z-<prerelease_label> , в котором <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

использует параметр имени для указания модуля PowerShellGet. Параметр пути указывает место хранения загруженного модуля. Параметр репозитория указывает зарегистрированный репозиторий 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

использует параметр имени для указания модуля PowerShellGet. Параметр пути указывает место хранения загруженного модуля. Параметр репозитория указывает зарегистрированный репозиторий 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

использует параметр имени для указания модуля PowerShellGet. Параметр репозитория указывает зарегистрированный репозиторий PSGallery. RequiredVersion указывает версию 1.6.5.

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

Параметры

-AcceptLicense

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

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-AllowPrerelease

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

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

NameAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Confirm

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

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	False
Поддержка подстановочных знаков:	False
Не показывайте:	False
Псевдонимы:	cf

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Credential

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

Свойства параметров

Тип:	PSCredential
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Force

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

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

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

Свойства параметров

Тип:	PSObject[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

InputObjectAndLiteralPathParameterSet

Позиция:	0
Обязательный:	True
Ценность воронки продаж:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

InputObjectAndPathParameterSet

Позиция:	0
Обязательный:	True
Ценность воронки продаж:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-LiteralPath

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False
Псевдонимы:	PSPath

Наборы параметров

NameAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	True
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

InputObjectAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	True
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-MaximumVersion

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

NameAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-MinimumVersion

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

NameAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Name

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

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	0
Обязательный:	True
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

NameAndLiteralPathParameterSet

Позиция:	0
Обязательный:	True
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Path

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	True
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	1
Обязательный:	True
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

InputObjectAndPathParameterSet

Позиция:	1
Обязательный:	True
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Proxy

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

Свойства параметров

Тип:	Uri
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ProxyCredential

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

Свойства параметров

Тип:	PSCredential
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Repository

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

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

NameAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-RequiredVersion

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

NameAndPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

NameAndLiteralPathParameterSet

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	False
Поддержка подстановочных знаков:	False
Не показывайте:	False
Псевдонимы:	wi

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входы

String

PSObject

String

Uri

PSCredential

Выходы

Object

Примечания

Это важно

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

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

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