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


Register-PSRepository

Регистрирует репозиторий 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.

Информация о зарегистрированных репозиториях привязана к конкретному пользователю. Они не регистрируются в контексте всей системы.

Это командлет прокси-сервера для командлета Register-PSResourceRepository в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в разделе Register-PSResourceRepository.

Примеры

Пример 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

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-Default

Регистрирует коллекция PowerShell в качестве репозитория по умолчанию.

Командлет прокси-сервера преобразует значение этого параметра в параметр PSGallery для Register-PSResourceRepository.

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

-InstallationPolicy

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

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

Командлет прокси-сервера преобразует значение этого параметра в доверенный Register-PSResourceRepositoryпараметр .

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-PackageManagementProvider

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-Proxy

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-ProxyCredential

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-PublishLocation

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-ScriptPublishLocation

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-ScriptSourceLocation

Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Register-PSResourceRepository.

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

-SourceLocation

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

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

Командлет прокси-сервера сопоставляет этот параметр с параметром URIRegister-PSResourceRepository

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

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

PSCredential

Uri

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

Object

Примечания

Коллекция PowerShell больше не поддерживает протокол TLS версий 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Чтобы проверить, используется ли TLS 1.2, выполните следующую команду:

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