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

Register-PSRepository

  • Ссылка
Модуль:
PowerShellGet

Регистрирует репозиторий PowerShell.

Синтаксис

Register-PSRepository
        [-Name] <String>
        [-SourceLocation] <Uri>
        [-PublishLocation <Uri>]
        [-ScriptSourceLocation <Uri>]
        [-ScriptPublishLocation <Uri>]
        [-Credential <PSCredential>]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [-PackageManagementProvider <String>]
        [<CommonParameters>]
Register-PSRepository
        [-Default]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [<CommonParameters>]

Описание

Командлет Register-PSRepository регистрирует репозиторий по умолчанию для модулей PowerShell. После регистрации репозитория вы можете ссылаться на него из командлетов Find-Module, Install-Moduleи Publish-Module. Зарегистрированный репозиторий становится репозиторием по умолчанию в Find-Module и Install-Module.

Зарегистрированные репозитории зависят от пользователя. Они не регистрируются в системном контексте.

Каждый зарегистрированный репозиторий связан с поставщиком пакетов OneGet, который указан с параметром PackageManagementProvider. Каждый поставщик OneGet предназначен для взаимодействия с определенным типом репозитория. Например, поставщик NuGet предназначен для взаимодействия с репозиториями на основе NuGet. Если поставщик OneGet не указан во время регистрации, PowerShellGet пытается найти поставщика OneGet, который может обрабатывать указанное исходное расположение.

Примеры

Пример 1. Регистрация репозитория

$parameters = @{
  Name = "myNuGetSource"
  SourceLocation = "https://www.myget.org/F/powershellgetdemo/api/v2"
  PublishLocation = "https://www.myget.org/F/powershellgetdemo/api/v2/Packages"
  InstallationPolicy = 'Trusted'
}
Register-PSRepository @parameters
Get-PSRepository

Name                SourceLocation          OneGetProvider       InstallationPolicy
----                --------------          --------------       ------------------
PSGallery           http://go.micro...      NuGet                Untrusted
myNuGetSource       https://myget.c...      NuGet                Trusted

Первая команда регистрирует https://www.myget.org/F/powershellgetdemo/ в качестве репозитория для текущего пользователя. После регистрации myNuGetSource вы можете явно ссылаться на него при поиске, установке и публикации модулей. Так как параметр packageManagementProvider не указан, репозиторий не связан явным образом с поставщиком пакетов OneGet, поэтому PowerShellGet опрашивает доступных поставщиков пакетов и связывает его с поставщиком NuGet.

Вторая команда получает зарегистрированные репозитории и отображает результаты.

Параметры

-Credential

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

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

-Default

Параметр используется для регистрации PSGallery. Это необходимо сделать только при удалении репозитория PSGallery.

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

-InstallationPolicy

Указывает политику установки. Допустимые значения: доверенные, ненадежные. Значение по умолчанию — UnTrusted.

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

Можно задать InstallationPolicy с помощью командлета Set-PSRepository.

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

-Name

Указывает имя репозитория для регистрации. Это имя можно использовать для указания репозитория в командлетах, таких как Find-Module и Install-Module.

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

-PackageManagementProvider

Указывает поставщик пакетов OneGet. Если значение этого параметра не указано, PowerShellGet опрашивает доступных поставщиков пакетов и связывает этот репозиторий с первым поставщиком пакетов, указывающим, что он может обрабатывать репозиторий.

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

-Proxy

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

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

-ProxyCredential

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

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

-PublishLocation

Задает универсальный код ресурса (URI) расположения публикации. Например, для репозиториев на основе NuGet расположение публикации аналогично https://someNuGetUrl.com/api/v2/Packages.

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

-ScriptPublishLocation

Указывает расположение публикации скрипта.

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

-ScriptSourceLocation

Указывает расположение источника скрипта.

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

-SourceLocation

Задает универсальный код ресурса (URI) для обнаружения и установки модулей из этого репозитория. URI может быть веб-каналом сервера NuGet (наиболее распространенной ситуацией), HTTP, HTTPS, FTP или расположением файла.

Например, для репозиториев на основе NuGet исходное расположение аналогично https://someNuGetUrl.com/api/v2.

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

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

PSCredential

Uri

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

Object

Примечания

Важный

По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Дополнительные сведения см. в объявления в блоге PowerShell.