Install-PSResource
Устанавливает ресурсы из зарегистрированного репозитория.
Синтаксис
NameParameterSet (По умолчанию)
Install-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObjectParameterSet
Install-PSResource
[-InputObject] <PSResourceInfo[]>
[-Repository <String[]>]
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RequiredResourceFileParameterSet
Install-PSResource
-RequiredResourceFile <String>
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RequiredResourceParameterSet
Install-PSResource
-RequiredResource <Object>
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет устанавливает ресурсы из зарегистрированного репозитория в путь установки на компьютере. По умолчанию командлет не возвращает объект. Другие параметры позволяют указать репозиторий, область и версию ресурса и отключить запросы лицензий.
Этот командлет объединяет функции командлетов Install-Module и Install-Script из PowerShellGet версии 2.
Install-PSResource не загружает только что установленный модуль в текущий сеанс. Чтобы использовать обновленный модуль, необходимо импортировать новую версию или запустить новый сеанс. Дополнительные сведения см. в разделе Import-Module.
Замечание
Install-PSResource не устанавливает зависимые ресурсы из репозиториев, использующих протокол NuGet версии 3. Необходимо установить зависимые ресурсы по отдельности. Мы намерены добавить эту функцию в будущий выпуск.
Примеры
Пример 1
Устанавливает последнюю стабильную версию модуля Az из коллекции PowerShell.
Install-PSResource Az -Repository PSGallery
Модуль Az — это метамодул, который включает все модули Az PowerShell в качестве зависимостей. Эта команда устанавливает модуль Az и все его зависимости.
Пример 2
Устанавливает последнюю стабильную модуль Az в пределах между версиями 7.3.0 и 8.3.0.
Install-PSResource Az -Version '[7.3.0, 8.3.0]'
Пример 3
Устанавливает последнюю стабильную версию модуля Az. При использовании параметра переустановки командлет записывает любую ранее установленную версию.
Install-PSResource Az -Reinstall
Пример 4
Устанавливает PSResources, указанные в файле psd1.
Install-PSResource -RequiredResourceFile myRequiredModules.psd1
Пример 5
Устанавливает PSResources, указанные в хэш-файле.
Install-PSResource -RequiredResource @{
TestModule = @{
version = '[0.0.1,1.3.0]'
repository = 'PSGallery'
}
TestModulePrerelease = @{
version = '[0.0.0,0.0.5]'
repository = 'PSGallery'
prerelease = 'true'
}
TestModule99 = @{}
}
Параметры
-AcceptLicense
Указывает, что ресурс должен принять любой запрос на принятие лицензионного соглашения. Это подавляет запрос, если модуль требует, чтобы пользователь принял лицензионное соглашение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AuthenticodeCheck
Проверяет подписи Authenticode и файлы каталога в Windows.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
| Псевдонимы: | cf |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Необязательные учетные данные, используемые при доступе к репозиторию.
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Используется для ввода конвейера.
Свойства параметров
| Тип: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
| Псевдонимы: | Родительский ресурс |
Наборы параметров
InputObjectParameterSet
| Позиция: | 0 |
| Обязательный: | True |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Имя одного или нескольких ресурсов для установки.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
NameParameterSet
| Позиция: | 0 |
| Обязательный: | True |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NoClobber
Запрещает установку пакета, содержащего командлеты, которые уже существуют на компьютере.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
При указании выводит объект PSResourceInfo для сохраненного ресурса.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Prerelease
При указании включает предварительные версии в возвращаемых результатах поиска.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
| Псевдонимы: | Пререлиз |
Наборы параметров
NameParameterSet
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Quiet
Подавляет индикатор выполнения установки.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Reinstall
Устанавливает последнюю версию модуля, даже если установлена последняя версия. Установленная версия перезаписана. Это позволяет восстановить поврежденную установку модуля.
Если установлена более ранняя версия модуля, новая версия устанавливается параллельно в новой папке для конкретной версии.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Repository
Указывает одно или несколько имен репозитория для поиска. Если это не указано, поиск включает все зарегистрированные репозитории в порядке приоритета (в первом порядке), пока не будет найден репозиторий, содержащий пакет. Репозитории сортируются по приоритету, а затем по имени. Более низкие приоритет значений имеют более высокий приоритет.
При поиске ресурсов в нескольких репозиториях PSResourceGet выполняет поиск репозиториев с помощью этого порядка сортировки.
Install-PSResource устанавливает первый соответствующий пакет из отсортированного списка репозиториев.
Параметр поддерживает * подстановочный знак. Если указать несколько репозиториев, все имена должны содержать или опустить подстановочный знак. Нельзя указать сочетание имен с подстановочными знаками и без нее.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | True |
| Не показывайте: | False |
Наборы параметров
NameParameterSet
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
InputObjectParameterSet
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-RequiredResource
Хэш-строка или строка JSON, указывающая ресурсы для установки. Подстановочные знаки не допускаются. Описание форматов файлов см. в разделе NOTES.
Свойства параметров
| Тип: | Object |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
RequiredResourceParameterSet
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RequiredResourceFile
Путь к .psd1 или .json, указывающий ресурсы для установки. Подстановочные знаки не допускаются. Описание форматов файлов см. в разделе NOTES.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
RequiredResourceFileParameterSet
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Scope
Указывает область установки. Допустимые значения:
CurrentUserAllUsers
Область по умолчанию CurrentUser, которая не требует повышения прав для установки.
Область AllUsers устанавливает модули в расположении, доступном всем пользователям компьютера. Рассмотрим пример.
$env:ProgramFiles\PowerShell\Modules
CurrentUser устанавливает модули в расположении, доступном только текущему пользователю компьютера. Рассмотрим пример.
$home\Documents\PowerShell\Modules
Свойства параметров
| Тип: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Значение по умолчанию: | None |
| Принимаемые значения: | CurrentUser, AllUsers |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipDependencyCheck
Пропускает проверку зависимостей ресурсов. Установлены только найденные ресурсы. Не установлены ресурсы найденного ресурса.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TemporaryPath
Указывает путь для временной установки ресурса перед фактической установкой. Если временный путь не указан, ресурс временно устанавливается в временной папке текущего пользователя.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TrustRepository
Подавляйте запросы на доверие репозитория. Запрос на доверие к репозиторию возникает только в том случае, если репозиторий не настроен как доверенный.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Version
Указывает версию возвращаемого ресурса. Значение может быть точной версией или диапазоном версий с помощью синтаксиса управления версиями NuGet.
Дополнительные сведения о диапазонах версий NuGet см. в управления версиями пакетов.
PowerShellGet поддерживает все, кроме минимальной инклюзивной версии , перечисленных в документации по диапазону версий NuGet. Использование 1.0.0.0, так как версия не дает версий 1.0.0.0 и выше (минимальный инклюзивный диапазон). Вместо этого значение считается обязательной версией. Чтобы найти минимальный диапазон включительно, используйте [1.0.0.0, ] в качестве диапазона версий.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | True |
| Не показывайте: | False |
Наборы параметров
NameParameterSet
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.
Свойства параметров
| Тип: | 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
SwitchParameter
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Выходы
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
По умолчанию командлет не возвращает объекты. При использовании параметра PassThru командлет выводит объект PSResourceInfo для сохраненного ресурса.
Примечания
Модуль определяет isres как псевдоним для Install-PSResource.
Параметры RequiredResource и RequiredResourceFile используются для поиска объектов PSResource, соответствующих определенным критериям. Критерии поиска можно указать с помощью хэш-файла или объекта JSON. Для параметра RequiredResourceFile хэш-файл хранится в файле .psd1, а объект JSON хранится в файле .json. Дополнительные сведения см. в about_PSResourceGet.
