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
Дополнительные сведения см. в объявления