Update-Module
Загружает и устанавливает последнюю версию указанных модулей из коллекции в сети на локальный компьютер.
Синтаксис
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Update-Module устанавливает последнюю версию модуля из онлайн-коллекции. Перед установкой обновления появится запрос на подтверждение. Обновления устанавливаются только для модулей, установленных на локальном компьютере с Install-Module.
Update-Module выполняет поиск $env:PSModulePath установленных модулей.
Update-Module без указанных параметров обновляет все установленные модули. Чтобы указать модуль для обновления, используйте параметр имени
Параметры, которые принимают номера версий модуля, ожидают строки, отформатированные как номера версий.
- Номера стандартных версий имеют формат
x.y.z, в котором x, y и z являются числами - Предварительные версии имеют формат
x.y.z-<prerelease_label>, в котором<prerelease_label>является произвольная строка, назначенная данному выпуску.
Если установленный модуль уже является последней версией, модуль не обновляется. Если модуль не найден в $env:PSModulePath, отображается ошибка.
Чтобы отобразить установленные модули, используйте Get-InstalledModule.
Примеры
Пример 1. Обновление всех модулей
В этом примере все установленные модули обновляются до последней версии в коллекции в сети.
Update-Module
Пример 2. Обновление модуля по имени
В этом примере обновляется конкретный модуль до последней версии в коллекции в сети.
Update-Module -Name SpeculationControl
Пример 3. Просмотр Update-Module запусков Update-Module
В этом примере выполняется сценарий what-if, чтобы показать, что происходит, если выполняется Update-Module. Команда не выполняется.
Update-Module -WhatIf
What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
'SpeculationControl', updating to version '1.0.14'".
Update-Module использует параметр WhatIf, что произойдет при выполнении Update-Module.
Пример 4. Обновление модуля до указанной версии
В этом примере модуль обновляется до определенной версии. Версия должна существовать в онлайн-коллекции или отображается ошибка.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Пример 5. Обновление модуля без подтверждения
Этот пример не запрашивает подтверждение обновления модуля до последней версии из коллекции в Сети. Если модуль уже установлен, параметр force
Update-Module -Name SpeculationControl -Force
Параметры
-AcceptLicense
Автоматически примите лицензионное соглашение во время установки, если пакет требует его.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AllowPrerelease
Позволяет обновить модуль с более новым модулем, помеченным как предварительная версия.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском Update-Module.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
| Псевдонимы: | cf |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, которая имеет разрешение на обновление модуля.
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Force
Принудительно обновляет каждый указанный модуль без запроса подтверждения. Если модуль уже установлен, Force переустановит модуль.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MaximumVersion
Указывает максимальную версию одного модуля для обновления. Этот параметр нельзя добавить, если вы пытаетесь обновить несколько модулей. Параметр MaximumVersion и параметры RequiredVersion нельзя использовать в той же команде.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Задает имена одного или нескольких модулей для обновления.
Update-Module выполняет поиск $env:PSModulePath для обновления модулей. Если совпадения не найдены в $env:PSModulePath для указанного имени модуля, возникает ошибка.
Подстановочные знаки принимаются в именах модулей. Если вы добавляете подстановочные знаки в указанное имя и совпадения не найдены, ошибка не возникает.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | True |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | 0 |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Proxy
Указывает прокси-сервер для запроса, а не подключение непосредственно к интернет-ресурсу.
Свойства параметров
| Тип: | Uri |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ProxyCredential
Указывает учетную запись пользователя, которая имеет разрешение на использование прокси-сервера, указанного параметром Proxy .
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-RequiredVersion
Указывает точную версию, к которой будет обновлен существующий установленный модуль. Версия, указанная RequiredVersion, должна существовать в коллекции в сети или отображается ошибка. Если в одной команде обновляется несколько модулей, нельзя использовать RequiredVersion.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Scope
Указывает область установки модуля. Допустимые значения для этого параметра : AllUsers и CurrentUser. Если область не указана, обновление устанавливается в области CurrentUser .
Область AllUsers требует повышенных разрешений и устанавливает модули в расположении, доступном всем пользователям компьютера:
$env:ProgramFiles\PowerShell\Modules
CurrentUser не требует повышенных разрешений и устанавливает модули в расположении, доступном только текущему пользователю компьютера:
$HOME\Documents\PowerShell\Modules
Если область не определена, значение по умолчанию устанавливается на основе версии PowerShellGet.
- В PowerShellGet версии 2.0.0 и выше значение по умолчанию — CurrentUser, для которого не требуется повышение прав для установки.
- В версиях PowerShellGet 1.x значение по умолчанию — AllUsers, для которого требуется повышение прав для установки.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | CurrentUser |
| Принимаемые значения: | CurrentUser, AllUsers |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если Update-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
String
PSCredential
Uri
Выходы
Object
Примечания
PowerShell включает следующие псевдонимы для Update-Module:
- Все платформы:
upmo
Для PowerShell версии 6.0 и выше область установки по умолчанию всегда является CurrentUser.
Обновления модулей для CurrentUser, $HOME\Documents\PowerShell\Modules, не требуют повышенных разрешений. Обновления модулей для AllUsers, $env:ProgramFiles\PowerShell\Modulesтребуют повышенных разрешений.
Это важно
По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Дополнительные сведения см. в объявления
Update-Module выполняется в powerShell 3.0 или более поздних выпусках PowerShell в Windows 7 или Windows 2008 R2 и более поздних выпусках Windows.
Если модуль, указанный с параметром Name , не был установлен, Install-Moduleвозникает ошибка.
Вы можете запускать Update-Module только в модулях, установленных из коллекции в Сети, выполнив Install-Module.
Если Update-Module пытается обновить двоичные файлы, используемые, Update-Module возвращает ошибку, которая идентифицирует процессы проблемы. Пользователь уведомляется повторить Update-Module после остановки процессов.
