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 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/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
| 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/package。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ScriptPublishLocation
指定脚本的发布位置的 URI。 例如,对于基于 NuGet 的存储库,发布位置类似于 https://someNuGetUrl.com/api/v2/package/。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | 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
| 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 博客中的 公告。