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

Set-PSResourceRepository

  • Ссылка
Модуль:
Microsoft.PowerShell.PSResourceGet

Задает сведения для зарегистрированного репозитория.

Синтаксис

Set-PSResourceRepository
   [-Name] <String>
   [-Uri <String>]
   [-Trusted]
   [-Priority <Int32>]
   [-ApiVersion <APIVersion>]
   [-CredentialInfo <PSCredentialInfo>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSResourceRepository
   -Repository <Hashtable[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-PSResourceRepository задает сведения для зарегистрированного репозитория.

Примеры

Пример 1

В этом примере зарегистрирован универсальный код ресурса (URI) для репозитория PoshTestGallery . Командлет Set-PSResourceRepository используется для изменения URI на локальный путь. Параметр PassThru позволяет просмотреть измененный репозиторий.

Get-PSResourceRepository -Name "PoshTestGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

Set-PSResourceRepository -Name "PoshTestGallery" -Uri "c:/code/testdir" -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  file:///c:/code/testdir                        False         50

Пример 2

В этом примере изменяются значения Priority и Trusted репозитория.

Примечание

Значение URI репозитория PSGallery по умолчанию изменить нельзя.

Get-PSResourceRepository -Name "PSGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50

Set-PSResourceRepository -Name "PSGallery" -Priority 25 -Trusted -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         25

Пример 3

В этом примере используется параметр Repository для изменения значений для нескольких репозиториев. Параметр принимает массив хэш-данных. Каждая хэш-строка содержит сведения об обновляемом репозитории.

Get-PSResourceRepository

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

$arrayOfHashtables = @{Name = "PSGallery"; Trusted = $True},
                     @{Name = "PoshTestGallery"; Uri = "c:/code/testdir"}
Set-PSResourceRepository -Repository $arrayOfHashtables -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         50
PoshTestGallery  file:///c:/code/testdir                        False         50

Пример 4

В этом примере обновляется репозиторий с учетными данными, которые будут получены из зарегистрированного хранилища Microsoft.PowerShell.SecretManagement . Необходимо установить модуль Microsoft.PowerShell.SecretManagement и зарегистрированное хранилище, содержащее сохраненный секрет. Формат секрета должен соответствовать требованиям репозитория.

$parameters = @{
  Name = "PoshTestGallery"
  Uri = "c:/code/testdir"
  CredentialInfo = [Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Set-PSResourceRepository @parameters -PassThru |
    Select-Object * -ExpandProperty CredentialInfo

Name           : PoshTestGallery
Uri            : file:///c:/code/testdir
Trusted        : False
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Параметры

-ApiVersion

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

  • v2 — использует API NuGet версии 2.
  • v3 — использует API NuGet версии 3.
  • local — используется для репозиториев на основе файловой системы.
  • nugetServer — используйте его для репозиториев на основе NuGet.Server.

Командлет Register-PSResourceRepository должен автоматически определить версию API. Этот параметр позволяет изменить версию API после регистрации репозитория.

Тип:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Допустимые значения:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

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

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

-CredentialInfo

Объект PSCredentialInfo , включающий имя хранилища и секрет, хранящийся в хранилище Microsoft.PowerShell.SecretManagement .

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

-Name

Указывает имя изменяемого репозитория.

Примечание

Значение URI репозитория PSGallery по умолчанию изменить нельзя.

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

-PassThru

При указании отображает успешно зарегистрированный репозиторий и его сведения.

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

-Priority

Указывает приоритет репозитория. Допустимые значения приоритета варьируются от 0 до 100. Более низкие значения имеют более высокий приоритет. Значение по умолчанию — 50.

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

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

-Repository

Задает массив хэш-таблицей, содержащих сведения о репозитории. Используйте этот параметр для регистрации нескольких репозиториев одновременно. Каждая хэш-сводка может иметь только ключи, связанные с параметрами для NameParameterSet.

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

-Trusted

Указывает, должен ли репозиторий быть доверенным.

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

-Uri

Указывает расположение репозитория для регистрации. Значение должно использовать одну из следующих схем URI:

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

-WhatIf

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

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

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

String

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

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

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