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 указывает, где хранить скачанный модуль. Параметр репозитория указывает зарегистрированный репозиторий 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
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Save-PSResource.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AllowPrerelease
Позволяет сохранить модуль, помеченный как предварительная версия.
Командлет прокси-сервера сопоставляет этот параметр с параметром Save-PSResourcePrerelease .
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском Save-Module.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Credential
Указывает учетную запись пользователя, которая имеет права на сохранение модуля.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Force
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Save-PSResource.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Принимает объект PSRepositoryItemInfo . Например, вывод Find-Module в переменную и использование этой переменной в качестве аргумента InputObject .
| Тип: | PSObject[] |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LiteralPath
Указывает путь к одному или нескольким расположениям. Значение параметра LiteralPath используется точно так же, как введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите их в одинарные кавычки. PowerShell не интерпретирует никакие символы, заключенные в одинарные кавычки, как escape-последовательности.
Командлет прокси-сервера сопоставляет этот параметр с параметром Save-PSResourcePath .
| Тип: | String |
| Aliases: | PSPath |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-MaximumVersion
Командлет прокси-сервера использует значение этого параметра для создания строки поиска версий NuGet для использования с параметром Save-PSResourceVersion.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-MinimumVersion
Командлет прокси-сервера использует значение этого параметра для создания строки поиска версий NuGet для использования с параметром Save-PSResourceVersion.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Задает массив имен модулей для сохранения.
| Тип: | String[] |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Path
Указывает расположение на локальном компьютере для хранения сохраненного модуля. Принимает подстановочные знаки.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | True |
-Proxy
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Save-PSResource.
| Тип: | Uri |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ProxyCredential
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Save-PSResource.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Repository
Указывает понятное имя репозитория, зарегистрированного с помощью запуска Register-PSRepository. Используется Get-PSRepository для отображения зарегистрированных репозиториев.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-RequiredVersion
Командлет прокси-сервера использует значение этого параметра для создания строки поиска версий NuGet для использования с параметром Save-PSResourceVersion.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если запустится Save-Module. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
String[]
PSObject[]
Выходные данные
Примечания
Коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
PSResourceGet