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


Update-PSResource

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

Синтаксис

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Update-PSResource загружает и устанавливает последнюю версию пакета, уже установленную на локальном компьютере. Этот командлет заменяет Update-Module командлеты и Update-Script командлеты из PowerShellGet версии 2. Новая версия ресурса устанавливается параллельно с предыдущими версиями в новой папке с версиями.

По умолчанию устанавливает последнюю версию Update-PSResource пакета и любую из зависимостей без удаления более старых версий. Нет команды для удаления старых версий пакета. Необходимо вручную удалить файлы и папки более старых версий.

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

Примеры

Пример 1

В этом примере пользователь уже установил пакет TestModule и обновил пакет.

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

Параметры

-AcceptLicense

Для ресурсов, требующих лицензии, AcceptLicense автоматически принимает лицензионное соглашение во время обновления.

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

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

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Тип:PSCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

При указании обходы проверяет наличие TrustRepository и AcceptLicense и обновляет пакет.

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Указывает имя одного или нескольких ресурсов для обновления. Подстановочные знаки поддерживаются, но NuGet принимает * только символ. NuGet не поддерживает поиск подстановочных знаков локальных репозиториев (на основе файлов).

Тип:String[]
Position:0
значение по умолчанию:"*"
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

При указании разрешает обновление до предварительной версии.

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Quiet

Подавляет сведения о ходе выполнения.

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

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

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

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

Тип:String[]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:True

-Scope

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

  • CurrentUser
  • AllUsers

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

Тип:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
допустимые значения:CurrentUser, AllUsers
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

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

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

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

Тип:SwitchParameter
Position:Named
значение по умолчанию:False
Обязательно: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, ] в качестве диапазона версий.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
значение по умолчанию:False
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

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

String[]

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

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

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

Примечания

Модуль определяется udres как псевдоним для Update-PSResource.