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>]
说明
cmdlet Register-PSRepository
注册 PowerShell 模块的默认存储库。 注册存储库后,可以从 、 Install-Module
和 Publish-Module
cmdlet 引用它Find-Module
。 注册的存储库将成为 和 Install-Module
中的Find-Module
默认存储库。
已注册的存储库是特定于用户的存储库。 它们不是在整个系统范围上下文中注册的。
这是 Microsoft.PowerShell.PSResourceGet 中 cmdlet 的代理 Register-PSResourceRepository
cmdlet。 有关详细信息,请参阅 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
代理 cmdlet 会忽略此参数,因为它不受 支持 Register-PSResourceRepository
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Default
将PowerShell 库注册为默认存储库。
代理 cmdlet 将此参数的值转换为 的 Register-PSResourceRepository
PSGallery 参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationPolicy
指定安装策略。 有效值为:Trusted、UnTrusted。 默认值为 UnTrusted。
存储库的安装策略指定从该存储库安装时的 PowerShell 行为。 从不受信任的存储库安装模块时,系统会提示用户进行确认。
代理 cmdlet 将此参数的值转换为 的Register-PSResourceRepository
受信任参数。
Type: | String |
Accepted values: | Trusted, Untrusted |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定要注册的存储库的名称。 可以使用此名称在 cmdlet(如 和 Install-Module
)Find-Module
中指定存储库。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageManagementProvider
代理 cmdlet 会忽略此参数,因为它不受 支持 Register-PSResourceRepository
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
代理 cmdlet 会忽略此参数,因为它不受 支持 Register-PSResourceRepository
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
代理 cmdlet 会忽略此参数,因为它不受 支持 Register-PSResourceRepository
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublishLocation
代理 cmdlet 会忽略此参数,因为它不受 支持 Register-PSResourceRepository
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptPublishLocation
代理 cmdlet 会忽略此参数,因为它不受 支持 Register-PSResourceRepository
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptSourceLocation
代理 cmdlet 会忽略此参数,因为它不受 支持 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
。
代理 cmdlet 将此参数映射到 的 URI 参数 Register-PSResourceRepository
Type: | Uri |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
输出
备注
PowerShell 库不再支持传输层安全性 (TLS) 版本 1.0 和 1.1。 必须使用 TLS 1.2 或更高版本。 使用以下命令可以确定使用的是 TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12