Install-Module

Install-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Install-Module
    [-InputObject] <PSObject[]>
    [-Credential <PSCredential>]
    [-Scope <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-Force]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Командлет Install-Module получает один или несколько модулей, которые соответствуют указанным условиям из онлайн-репозитория. Командлет проверяет, являются ли результаты поиска допустимыми модулями и копирует папки модулей в расположение установки. Установленные модули не импортируются автоматически после установки. Вы можете фильтровать модуль на основе минимальной, максимальной и точной версии указанных модулей.

Это командлет прокси-сервера для командлета Get-InstalledPSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе Install-PSResource.

Этот пример находит модуль в репозитории и устанавливает модуль.

Find-Module -Name PowerShellGet | Install-Module

Использует Find-Module параметр Name для указания модуля PowerShellGet . По умолчанию последняя версия модуля загружается из репозитория. Объект отправляется по конвейеру командлету Install-Module . Install-Moduleустанавливает модуль для всех пользователей.$env:ProgramFiles\PowerShell\Modules

В этом примере устанавливается последняя версия модуля PowerShellGet .

Install-Module -Name PowerShellGet

Использует Install-Module параметр Name для указания модуля PowerShellGet . По умолчанию последняя версия модуля загружается из репозитория и устанавливается.

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

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

Использует Install-Module параметр Name для указания модуля PowerShellGet . Параметр MinimumVersion указывает, что версия 2.0.1 загружается из репозитория и установлена. Так как доступна версия 2.0.4 , эта версия загружается и устанавливается для всех пользователей.

В этом примере устанавливается определенная версия модуля PowerShellGet .

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

Использует Install-Module параметр Name для указания модуля PowerShellGet . Параметр RequiredVersion указывает, что для всех пользователей скачиваются и устанавливаются версии 2.0.0 .

Этот пример загружает и устанавливает последнюю версию модуля только для текущего пользователя.

Install-Module -Name PowerShellGet -Scope CurrentUser

Использует Install-Module параметр Name для указания модуля PowerShellGet . Install-Module загружает и устанавливает последнюю версию PowerShellGet в каталог $HOME\Documents\PowerShell\Modulesтекущего пользователя.

В этом примере показано, как установить последнюю версию модуля, когда эта версия является предварительной версией. Для установки предварительной версии требуется параметр AllowPrerelease .

Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease

Используя этот метод, вы получите последнюю версию. Если последняя версия не является предварительной, вы получите последнюю стабильную версию модуля.

В этом примере показано, как установить определенную предварительную версию модуля. Командлет Find-Module можно использовать для поиска предварительных версий модулей в коллекции PowerShell.

Предварительные версии имеют формат <version_number>-<prerelease_label>.

Find-Module PSReadLine -AllVersions -AllowPrerelease | Select-Object -First 5

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.6          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.5          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.3          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.2          PSReadLine       PSGallery        Great command line editing in the PowerS…

Install-Module -Name PSReadLine -RequiredVersion 2.2.4-beta1 -AllowPrerelease

Используйте версию, показанную в коллекции PowerShell, для значения параметра RequiredVersion .

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

Find-Module создает объекты PSRepositoryItemInfo , в которые можно отправить конвейер Install-Module.

При использовании параметра Install-Module выводит объект PSRepositoryItemInfo для модуля. Это те же сведения, которые вы получаете от командлета Find-Module .

PowerShell включает следующие псевдонимы для Install-Module:

• Все платформы:
  • inmo

Install-Module выполняется в выпусках PowerShell 5.0 или более поздних версий в Windows 7 или Windows 2008 R2 и более поздних выпусках Windows.

Рекомендуется оценить код модуля перед первым выполнением командлетов или функций. Чтобы предотвратить выполнение модулей, содержащих вредоносный код, установленные модули не импортируются автоматически после установки.

Если имя модуля, указанное параметром Name , не существует в репозитории, Install-Module возвращает ошибку.

Чтобы установить несколько модулей, используйте параметр Name и укажите разделенный запятыми массив имен модулей. Если указать несколько имен модулей, вы не можете использовать MinimumVersion, MaximumVersion или RequiredVersion. Find-Module создает объекты PSRepositoryItemInfo , в которые можно отправить конвейер Install-Module. Конвейер — это еще один способ указать несколько модулей для установки в одной команде.

По умолчанию модули для области AllUsers устанавливаются в $env:ProgramFiles\PowerShell\Modules. Значение по умолчанию предотвращает путаницу при установке ресурсов PowerShell Desired State Configuration (DSC).

Установка модуля завершается сбоем и не может быть импортирована, если она не имеет .psm1или .psd1.dll того же имени в папке. Используйте параметр Force для установки модуля.

Если версия существующего модуля соответствует имени, заданному параметром Name, а параметр MinimumVersion или RequiredVersion не используется, автоматически продолжается, но не устанавливает модуль.Install-Module

Если версия существующего модуля больше значения параметра MinimumVersion или равно значению параметра RequiredVersion, автоматически продолжается, Install-Module но не устанавливает модуль.

Если существующий модуль не соответствует значениям, указанным параметрам MinimumVersion или RequiredVersion , в команде Install-Module возникает ошибка. Например, если версия существующего установленного модуля меньше значения MinimumVersion или не равна значению RequiredVersion .

Install-Module также устанавливает все зависимые модули, указанные в соответствии с требованиями издателя модуля. Издатель перечисляет необходимые модули и их версии в манифесте модуля.