Register-PSRepository
註冊 PowerShell 存放庫。
Syntax
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>]
Description
Cmdlet Register-PSRepository
會註冊 PowerShell 模組的預設存放庫。 註冊存放庫之後,您可以從 、 Install-Module
和 Publish-Module
Cmdlet 參考它 Find-Module
。 已註冊的存放庫會變成 和 Install-Module
中的預設存放 Find-Module
庫。
已註冊的存放庫是使用者特有的。 它們並未註冊在整個系統內容中。
這是Microsoft.PowerShell.PSResourceGet中 Cmdlet 的 Proxy Cmdlet Register-PSResourceRepository
。 如需詳細資訊,請參閱 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
Proxy Cmdlet 會忽略此參數,因為它不受 支援 Register-PSResourceRepository
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Default
將PowerShell 資源庫註冊為預設存放庫。
Proxy 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 行為。 從 UnTrusted 存放庫安裝模組時,系統會提示使用者確認。
Proxy Cmdlet 會將此參數的值轉換為 的 Register-PSResourceRepository
Trusted參數。
Type: | String |
Accepted values: | Trusted, Untrusted |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定要註冊的存放庫名稱。 您可以使用這個名稱在 Cmdlet 中指定存放庫,例如 Find-Module
和 Install-Module
。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageManagementProvider
Proxy Cmdlet 會忽略此參數,因為它不受 支援 Register-PSResourceRepository
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
Proxy Cmdlet 會忽略此參數,因為它不受 支援 Register-PSResourceRepository
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Proxy Cmdlet 會忽略此參數,因為它不受 支援 Register-PSResourceRepository
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublishLocation
Proxy Cmdlet 會忽略此參數,因為它不受 支援 Register-PSResourceRepository
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptPublishLocation
Proxy Cmdlet 會忽略此參數,因為它不受 支援 Register-PSResourceRepository
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptSourceLocation
Proxy 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
。
Proxy 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