Поделиться через


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.

Install-PSResource не загружает только что установленный модуль в текущий сеанс. Чтобы использовать обновленный модуль, необходимо импортировать новую версию или запустить новый сеанс. Дополнительные сведения см. в разделе Import-Module.

Примеры

Пример 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

Указывает, что ресурс должен принять любой запрос на принятие лицензионного соглашения. Это подавляет запрос, если модуль требует, чтобы пользователь принял лицензионное соглашение.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AuthenticodeCheck

Проверяет подписи Authenticode и файлы каталога в Windows.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Credential

Необязательные учетные данные, используемые при доступе к репозиторию.

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Используется для ввода конвейера.

Тип:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Имя одного или нескольких ресурсов для установки.

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-NoClobber

Запрещает установку пакета, содержащего командлеты, которые уже существуют на компьютере.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

При указании выводит объект PSResourceInfo для сохраненного ресурса.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Prerelease

При указании включает предварительные версии в возвращаемых результатах поиска.

Тип:SwitchParameter
Aliases:IsPrerelease
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Quiet

Подавляет индикатор выполнения установки.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Reinstall

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

Если установлена более ранняя версия модуля, новая версия устанавливается параллельно в новой папке для конкретной версии.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Repository

Указывает одно или несколько имен репозитория для поиска. Если это не указано, поиск включает все зарегистрированные репозитории в порядке приоритета (в первом порядке), пока не будет найден репозиторий, содержащий пакет. Репозитории сортируются по приоритету, а затем по имени. Значения более низкого приоритета имеют более высокий приоритет .

При поиске ресурсов в нескольких репозиториях командлеты PSResourceGet выполняют поиск репозиториев с помощью этого порядка сортировки. Install-PSResource устанавливает первый соответствующий пакет из отсортированного списка репозиториев.

Параметр поддерживает подстановочный * знак. Если указать несколько репозиториев, все имена должны содержать или опустить подстановочный знак. Нельзя указать сочетание имен с подстановочными знаками и без нее.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-RequiredResource

Хэш-строка или строка JSON, указывающая ресурсы для установки. Подстановочные знаки не допускаются. Описание форматов файлов см. в разделе NOTES .

Тип:Object
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RequiredResourceFile

Путь к ресурсу .psd1 или .json указывает ресурсы для установки. Подстановочные знаки не допускаются. Описание форматов файлов см. в разделе NOTES .

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Scope

Указывает область установки. Допустимые значения:

  • CurrentUser
  • AllUsers

Область по умолчанию — CurrentUserэто область, которая не требует повышения прав для установки.

Область AllUsers устанавливает модули в расположении, доступном всем пользователям компьютера. Например:

  • $env:ProgramFiles\PowerShell\Modules

Модули CurrentUser устанавливаются в расположении, доступном только текущему пользователю компьютера. Например:

  • $home\Documents\PowerShell\Modules
Тип:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Допустимые значения:CurrentUser, AllUsers
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipDependencyCheck

Пропускает проверку зависимостей ресурсов. Установлены только найденные ресурсы. Не установлены ресурсы найденного ресурса.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TemporaryPath

Указывает путь для временной установки ресурса перед фактической установкой. Если временный путь не указан, ресурс временно устанавливается в временной папке текущего пользователя.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TrustRepository

Подавляйте запросы на доверие репозитория. Запрос на доверие к репозиторию возникает только в том случае, если репозиторий не настроен как доверенный.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Version

Указывает версию возвращаемого ресурса. Значение может быть точной версией или диапазоном версий с помощью синтаксиса управления версиями NuGet.

Дополнительные сведения о диапазонах версий NuGet см. в разделе "Управление версиями пакетов".

PowerShellGet поддерживает все, но минимальную включаемую версию , указанную в документации по диапазону версий NuGet. Использование 1.0.0.0 в качестве версии не дает версий 1.0.0.0 и выше (минимальный диапазон включительно). Вместо этого значение считается обязательной версией. Для поиска минимального инклюзивного диапазона используйте [1.0.0.0, ] в качестве диапазона версий.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

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.