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


Register-PSRepository

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

Синтаксис

NameParameterSet (По умолчанию)

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

PSGalleryParameterSet

Register-PSRepository
    [-Default]
    [-InstallationPolicy <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [<CommonParameters>]

Описание

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

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

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

Примеры

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

$parameters = @{
  Name = "myNuGetSource"
  SourceLocation = "https://www.myget.org/F/mypsrepository/api/v2"
  PublishLocation = "https://www.myget.org/F/mypsrepository/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/mypsrepository/ в качестве репозитория для текущего пользователя. После регистрации myNuGetSource вы можете явно ссылаться на него при поиске, установке и публикации модулей. Так как параметр packageManagementProvider не указан, репозиторий не связан явным образом с поставщиком пакетов OneGet, поэтому PowerShellGet опрашивает доступных поставщиков пакетов и связывает его с поставщиком NuGet.

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

Параметры

-Credential

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

Свойства параметров

Тип:PSCredential
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Default

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

PSGalleryParameterSet
Позиция:Named
Обязательный:True
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InstallationPolicy

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

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

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Принимаемые значения:Trusted, Untrusted
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:0
Обязательный:True
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PackageManagementProvider

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Proxy

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

Свойства параметров

Тип:Uri
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ProxyCredential

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

Свойства параметров

Тип:PSCredential
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PublishLocation

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

Свойства параметров

Тип:Uri
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ScriptPublishLocation

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

Свойства параметров

Тип:Uri
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ScriptSourceLocation

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

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

Свойства параметров

Тип:Uri
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SourceLocation

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

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

Свойства параметров

Тип:Uri
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

NameParameterSet
Позиция:1
Обязательный:True
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входы

PSCredential

Uri

Выходы

Object

Примечания

Это важно

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

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

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