Register-PSResourceRepository

Модуль:

Microsoft.PowerShell.PSResourceGet

Регистрирует репозиторий для ресурсов PowerShell.

Синтаксис

Register-PSResourceRepository
        [-Name] <String>
        [-Uri] <String>
        [-Trusted]
        [-Priority <Int32>]
        [-CredentialInfo <PSCredentialInfo>]
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Register-PSResourceRepository
        [-PSGallery]
        [-Trusted]
        [-Priority <Int32>]
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Register-PSResourceRepository
        -Repository <Hashtable[]>
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Описание

Командлет регистрирует репозиторий NuGet, содержащий ресурсы PowerShell.

Примеры

Пример 1

В этом примере репозиторий регистрируется с именемPoshTestGallery.

Register-PSResourceRepository -Name PoshTestGallery -Uri 'https://www.poshtestgallery.com/api/v2'
Get-PSResourceRepository -Name PoshTestGallery

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

Пример 2

В этом примере регистрируется репозиторий по умолчанию PSGallery . В отличие от предыдущего примера, мы не можем использовать параметры Name и URI для регистрации репозитория PSGallery . Репозиторий PSGallery зарегистрирован по умолчанию, но его можно удалить. Используйте эту команду для восстановления регистрации по умолчанию.

Register-PSResourceRepository -PSGallery
Get-PSResourceRepository -Name 'PSGallery'

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

Пример 3

В этом примере регистрируется несколько репозиториев одновременно. Для этого мы используем параметр Repository и предоставляем массив хэш-данных. У каждой хэш-схемы могут быть ключи, связанные только с параметрами для NameParameterSet или PSGalleryParameterSet.

$arrayOfHashtables = @{
        Name = 'Local'
        Uri = 'D:/PSRepoLocal/'
        Trusted = $true
        Priority = 20
    },
    @{
        Name = 'PSGv3'
        Uri = 'https://www.powershellgallery.com/api/v3'
        Trusted = $true
        Priority = 50
    },
    @{
        PSGallery = $true
        Trusted = $true
        Priority = 10
    }
Register-PSResourceRepository -Repository $arrayOfHashtables
Get-PSResourceRepository

Name      Uri                                      Trusted Priority
----      ---                                      ------- --------
PSGallery https://www.powershellgallery.com/api/v2 True    10
Local     file:///D:/PSRepoLocal/                  True    20
PSGv3     https://www.powershellgallery.com/api/v3 True    50

Пример 4

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

$parameters = @{
  Name = 'PSGv3'
  Uri = 'https://www.powershellgallery.com/api/v3'
  Trusted = $true
  Priority = 50
  CredentialInfo = [Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Register-PSResourceRepository @parameters
Get-PSResourceRepository | Select-Object * -ExpandProperty CredentialInfo

Name           : PSGv3
Uri            : https://www.powershellgallery.com/api/v3
Trusted        : True
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Параметры

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CredentialInfo

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

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Перезаписывает репозиторий, если он уже существует.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Имя регистраемого репозитория. Не может быть PSGallery.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

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

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

Type:	Int32
Position:	Named
Default value:	50
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PSGallery

При указании регистрирует репозиторий PSGallery .

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Repository

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

Type:	Hashtable[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Trusted

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Uri

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

• https://
• http://
• ftp://
• file://

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

None

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

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

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

Примечания

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

Связанные ссылки

• Microsoft.PowerShell.SecretManagement