Install-PSResource
Устанавливает ресурсы из зарегистрированного репозитория.
Синтаксис
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>]
Install-PSResource
[-Repository <String[]>]
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-InputObject] <PSResourceInfo[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PSResource
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
-RequiredResourceFile <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PSResource
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
-RequiredResource <Object>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет устанавливает ресурсы из зарегистрированного репозитория в путь установки на компьютере. По умолчанию командлет не возвращает объект . Другие параметры позволяют указать репозиторий, область и версию ресурса, а также отключить запросы лицензии.
Этот командлет объединяет функции командлетов Install-Module
и Install-Script
из PowerShellGet версии 2.
Примеры
Пример 1
Устанавливает последнюю стабильную (не предварительную) версию модуля Az .
Install-PSResource 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
Указывает, что ресурс должен принимать любые запросы на принятие лицензионного соглашения. Это отключает запрос, если модуль требует, чтобы пользователь принял лицензионное соглашение.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
Проверяет подписи Authenticode и файлы каталога в Windows.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
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: | False |
Accept wildcard characters: | False |
-InputObject
Используется для входных данных конвейера.
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Имя одного или нескольких ресурсов для установки.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
Запрещает установку пакета, содержащего командлеты, которые уже существуют на компьютере.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
При указании выводит объект PSResourceInfo для сохраненного ресурса.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
При указании включает предварительные версии в возвращаемые результаты поиска.
Type: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
Подавляет индикатор выполнения установки.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reinstall
Устанавливает последнюю версию модуля, даже если последняя версия уже установлена. Установленная версия перезаписывается. Это позволяет восстановить поврежденную установку модуля.
Если установлена более старая версия модуля, новая версия устанавливается параллельно в новой папке для конкретной версии.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Repository
Указывает одно или несколько имен репозитория для поиска. Если не указано, поиск включает все зарегистрированные репозитории в порядке приоритета (самый высокий первый), пока не будет найден репозиторий, содержащий пакет. Репозитории сортируются по приоритету, а затем по имени. Более низкий приоритет имеет более высокий приоритет.
При поиске ресурсов в нескольких репозиториях командлеты PSResourceGet выполняют поиск в репозиториях с использованием этого порядка сортировки. Install-PSResource
устанавливает первый соответствующий пакет из отсортированного списка репозиториев.
Параметр поддерживает подстановочный *
знак. Если указать несколько репозиториев, все имена должны включать или пропускать подстановочный знак. Нельзя указать сочетание имен с подстановочными знаками и без нее.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-RequiredResource
Хэш-таблице или строке JSON, указывающей устанавливаемые ресурсы. Подстановочные знаки не допускаются. Описание форматов файлов см. в разделе ЗАМЕТКИ .
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredResourceFile
Путь к объекту .psd1
или .json
, указывающий устанавливаемые ресурсы. Подстановочные знаки не допускаются. Описание форматов файлов см. в разделе ЗАМЕТКИ .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Указывает область установки. Допустимые значения:
CurrentUser
AllUsers
По умолчанию область является CurrentUser
, для установки которого не требуется повышение прав.
Область AllUsers
устанавливает модули в расположении, доступном всем пользователям компьютера. Пример:
$env:ProgramFiles\PowerShell\Modules
Устанавливает CurrentUser
модули в расположении, доступном только текущему пользователю компьютера. Пример:
$home\Documents\PowerShell\Modules
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipDependencyCheck
Пропускает проверка для зависимостей ресурсов. Устанавливаются только найденные ресурсы. Ресурсы найденного ресурса не установлены.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemporaryPath
Указывает путь для временной установки ресурса перед фактической установкой. Если временный путь не указан, ресурс временно устанавливается во временную папку текущего пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustRepository
Подавлять запросы на доверие репозитория. Запрос на доверие репозиторию возникает только в том случае, если репозиторий не настроен как доверенный.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Указывает версию возвращаемого ресурса. Значение может быть точной версией или диапазоном версий с помощью синтаксиса управления версиями NuGet.
Дополнительные сведения о диапазонах версий NuGet см. в разделе Управление версиями пакетов.
PowerShellGet поддерживает все версии, кроме минимальной инклюзивной, перечисленные в документации по диапазону версий NuGet. Использование 1.0.0.0
в качестве версии не дает версий 1.0.0.0 и выше (минимальный инклюзивный диапазон). Вместо этого значение считается обязательной версией. Чтобы найти минимальный инклюзивный диапазон, используйте [1.0.0.0, ]
в качестве диапазона версий.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
String[]
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.
Связанные ссылки
PSResourceGet
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по