Update-Module
Скачивает последние версии указанных модулей из веб-коллекции и устанавливает их на локальном компьютере.
Синтаксис
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-PSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе Update-PSResource.
Примеры
Пример 1. Обновление всех модулей
В этом примере все установленные модули обновляются до последней версии в онлайн-коллекции.
Update-ModuleПример 2. Обновление модуля по имени
В этом примере обновляется определенный модуль до последней версии в онлайн-коллекции.
Update-Module -Name SpeculationControlUpdate-Module использует параметр Name для обновления определенного модуля SpeculationControl.
Пример 3. Просмотр Update-Module выполнений Update-Module
В этом примере выполняется сценарий "что если", чтобы показать, что происходит при 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.14Update-Module использует параметр Name для указания модуля SpeculationControl. Параметр RequiredVersion указывает версию 1.0.14.
Пример 5. Обновление модуля без подтверждения
Этот пример не запрашивает подтверждение обновления модуля до последней версии из коллекции в Интернете. Если модуль уже установлен, параметр Force переустановит модуль.
Update-Module -Name SpeculationControl -ForceUpdate-Module использует параметр Name для указания модуля SpeculationControl. Параметр Force обновляет модуль без запроса подтверждения пользователя.
Параметры
-AcceptLicense
Автоматически примите лицензионное соглашение во время установки, если это требуется пакету.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrerelease
Позволяет обновить модуль с новым модулем, помеченным как предварительный выпуск.
Командлет прокси-сервера сопоставляет этот параметр с параметром Prerelease для Update-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Запрашивает подтверждение перед запуском Update-Module.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Указывает учетную запись пользователя, которая имеет разрешение на обновление модуля.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Принудительное обновление каждого указанного модуля без запроса на подтверждение. Если модуль уже установлен, принудительно переустановит модуль.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
Командлет прокси-сервера использует значение этого параметра для создания строки поиска версии NuGet для использования с параметром Version .Update-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Указывает имена одного или нескольких модулей для обновления. Update-Module выполняет поиск $env:PSModulePath модулей для обновления. Если совпадений для указанного имени модуля не найдено $env:PSModulePath , возникает ошибка.
Подстановочные знаки принимаются в именах модулей. Если вы добавляете подстановочные знаки в указанное имя и совпадений не найдено, ошибка не возникает.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Update-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Update-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
Командлет прокси-сервера использует значение этого параметра для создания строки поиска версии NuGet для использования с параметром Version .Update-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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, что требует повышения прав для установки.
| Type: | String |
| Accepted values: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | CurrentUser |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при выполнении Update-Module . Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
String[]
Выходные данные
Примечания
PowerShell включает следующие псевдонимы для Update-Module:
- Для всех платформ.
upmo
Для PowerShell версии 6.0 и более поздних область установки по умолчанию всегда является CurrentUser.
Обновления модулей для CurrentUser, $HOME\Documents\PowerShell\Modules, не требуют повышенных разрешений. Обновления модулей для AllUsers , $env:ProgramFiles\PowerShell\Modulesтребуют повышенных разрешений.
Коллекция PowerShell больше не поддерживает протокол TLS версий 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Чтобы проверить, используется ли TLS 1.2, выполните следующую команду:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [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 после остановки процессов.
Связанные ссылки
PSResourceGet