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 庫。

已註冊的存放庫是使用者特有的。 它們並未註冊在整個系統內容中。

這是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-PSResourceRepositoryPSGallery參數。

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-PSResourceRepositoryTrusted參數。

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

輸入

PSCredential

Uri

輸出

Object

備註

PowerShell 資源庫不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 您必須使用 TLS 1.2 或更高版本。 使用下列命令來確保您使用的是 TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12