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[]

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.