Register-PSRepository

注册 PowerShell 存储库。

语法

Default (默认值)

Register-PSRepository
    -Name <String>
    -SourceLocation <Uri>
    [-PublishLocation <Uri>]
    [-InstallationPolicy <String>]
    [-PackageManagementProvider <String>]
    [<CommonParameters>]

说明

Register-PSRepository cmdlet 注册 PowerShell 模块的默认存储库。 注册存储库后,可以从 Find-Module、Install-Module 和 Publish-Module cmdlet 引用它。 注册的存储库将成为 find-Module 中的默认存储库,Install-Module

已注册的存储库特定于用户。 它们未在系统范围的上下文中注册。

每个已注册的存储库都与 OneGet 包提供程序相关联,该提供程序使用 PackageManagementProvider 参数指定。 每个 OneGet 提供程序旨在与特定类型的存储库进行交互。 例如,NuGet 提供程序旨在与基于 NuGet 的存储库进行交互。 如果在注册期间未指定 OneGet 提供程序,PowerShellGet 将尝试查找可以处理指定源位置的 OneGet 提供程序。

示例

示例 1:注册存储库

PS C:\> Register-PSRepository -Name "myNuGetSource" -SourceLocation "https://www.myget.org/F/powershellgetdemo/api/v2" -PublishLocation "https://www.myget.org/F/powershellgetdemo/api/v2/Packages" -InstallationPolicy Trusted
PS C:\> 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 提供程序相关联。

第二个命令获取已注册的存储库并显示结果。

参数

-InstallationPolicy

指定安装策略。 有效值为:受信任、不受信任。 默认值为 UnTrusted。

从该存储库安装时,存储库的安装策略指定 PowerShell 行为。 从不受信任的存储库安装模块时,系统会提示用户进行确认。

可以使用 Set-PSRepository cmdlet 设置 InstallationPolicy

参数属性

类型:String
默认值:None
接受的值:Trusted, Untrusted
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

指定要注册的存储库的名称。 可以使用此名称在 cmdlet(如 Find-Module 和 Install-Module)中指定存储库。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PackageManagementProvider

指定 OneGet 包提供程序。 如果未为此参数指定值,PowerShellGet 将轮询可用的包提供程序,并将此存储库与指示它可以处理存储库的第一个包提供程序相关联。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PublishLocation

指定发布位置的 URI。 例如,对于基于 NuGet 的存储库,发布位置类似于 http://someNuGetUrl.com/api/v2/Packages

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SourceLocation

指定用于从此存储库中发现和安装模块的 URI。 URI 可以是 NuGet 服务器源(最常见的情况)、HTTP、HTTPS、FTP 或文件位置。

例如,对于基于 NuGet 的存储库,源位置类似于 http://someNuGetUrl.com/api/v2

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters