共用方式為

Register-PSRepository

  • 參考
模組:
PowerShellGet

註冊 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/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

指定有權註冊存放庫之帳戶的認證。

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 行為。 從 UnTrusted 存放庫安裝模組時，系統會提示使用者確認。

您可以使用 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/package 。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

指定腳本之發佈位置的 URI。 例如，針對 NuGet 型存放庫，發佈位置類似于 https://someNuGetUrl.com/api/v2/package/ 。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptSourceLocation

指定從這個存放庫探索和安裝腳本的 URI。 URI 可以是 NuGet 伺服器摘要， (最常見的情況) 、HTTP、HTTPS、FTP 或檔案位置。

例如，針對以 NuGet 為基礎的存放庫，來源位置類似于 https://someNuGetUrl.com/api/v2/items/psscript 。

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

輸入

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 部落格中的公告 \(英文\)。