Register-PSRepository

模块:

PowerShellGet Module

注册 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 cmdlet 注册 PowerShell 模块的默认存储库。 注册存储库后，可以从 和 Find-Module cmdlet 引用它。Install-ModulePublish-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
默认值:	None
支持通配符:	False
不显示:	False

参数集

NameParameterSet

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

-Default

该参数用于注册 PSGallery。 仅当删除 PSGallery 存储库时，才需要执行此作。

参数属性

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

参数集

PSGalleryParameterSet

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

-InstallationPolicy

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

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

可以使用 cmdlet 设置 InstallationPolicySet-PSRepository。

参数属性

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

参数集

(All)

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

-Name

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

参数属性

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

参数集

NameParameterSet

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PackageManagementProvider

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

参数属性

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

参数集

NameParameterSet

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

-Proxy

指定请求的代理服务器，而不是直接连接到 Internet 资源。

参数属性

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

参数集

(All)

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

-ProxyCredential

指定有权使用 Proxy 参数指定的代理服务器的用户帐户。

参数属性

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

参数集

(All)

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

-PublishLocation

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

参数属性

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

参数集

NameParameterSet

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

-ScriptPublishLocation

指定脚本发布位置。

参数属性

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

参数集

NameParameterSet

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

-ScriptSourceLocation

指定脚本源位置。

参数属性

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

参数集

NameParameterSet

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

-SourceLocation

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

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

参数属性

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

参数集

NameParameterSet

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

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

输入

PSCredential

Uri

输出

Object

备注

重要

截至 2020 年 4 月，PowerShell 库不再支持传输层安全性（TLS）版本 1.0 和 1.1。 如果未使用 TLS 1.2 或更高版本，则尝试访问 PowerShell 库时会收到错误。 使用以下命令确保使用的是 TLS 1.2：

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

有关详细信息，请参阅 PowerShell 博客中的 公告。

相关链接

• Get-PSRepository
• Set-PSRepository
• Unregister-PSRepository