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
預設存放庫。
已註冊的存放庫是使用者特有的。 它們並未註冊在整個系統內容中。
每個已註冊的存放庫都會與 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
指定有權註冊存放庫之帳戶的認證。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Default
參數是用來註冊 PSGallery。 如果您移除 PSGallery 存放庫 ,則只需要執行此動作。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationPolicy
指定安裝原則。 有效值為:Trusted、UnTrusted。 預設值為 UnTrusted。
從該存放庫安裝時,存放庫的安裝原則會指定 PowerShell 行為。 從未受信任的存放庫安裝模組時,系統會提示用戶確認。
您可以使用 Cmdlet 來設定 InstallationPolicySet-PSRepository
。
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
指定 OneGet 套件提供者。 如果您未指定此參數的值,PowerShellGet 會輪詢可用的套件提供者,並將此存放庫與指出它可以處理存放庫的第一個套件提供者產生關聯。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
指定要求的 Proxy 伺服器,而不是直接連線到因特網資源。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
指定具有使用 Proxy 參數所指定 Proxy 伺服器之權限的使用者帳戶。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublishLocation
指定發佈位置的 URI。 例如,針對以 NuGet 為基礎的存放庫,發佈位置類似於 https://someNuGetUrl.com/api/v2/Packages
。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptPublishLocation
指定文稿發佈位置。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptSourceLocation
指定文稿來源位置。
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
。
Type: | Uri |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
輸出
備註
重要
從 2020 年 4 月起,PowerShell 資源庫已不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 如果您不是使用 TLS 1.2 或更高版本,您在嘗試存取 PowerShell 資源庫時將會收到錯誤。 使用下列命令來確保您使用的是 TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
如需詳細資訊,請參閱 PowerShell 部落格中的公告 \(英文\)。