Register-PSRepository
Mendaftarkan repositori PowerShell.
Sintaks
NameParameterSet (Default)
Register-PSRepository
[-Name] <String>
[-SourceLocation] <Uri>
[-PublishLocation <Uri>]
[-ScriptSourceLocation <Uri>]
[-ScriptPublishLocation <Uri>]
[-Credential <PSCredential>]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-PackageManagementProvider <String>]
[<CommonParameters>]
PSGalleryParameterSet
Register-PSRepository
[-Default]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[<CommonParameters>]
Deskripsi
Register-PSRepository Cmdlet mendaftarkan repositori default untuk modul PowerShell. Setelah repositori terdaftar, Anda dapat mereferensikannya dari Find-Modulecmdlet , Install-Module, dan Publish-Module . Repositori terdaftar menjadi repositori default di Find-Module dan Install-Module.
Repositori terdaftar khusus pengguna. Mereka tidak terdaftar dalam konteks di seluruh sistem.
Setiap repositori terdaftar dikaitkan dengan penyedia paket OneGet, yang ditentukan dengan parameter PackageManagementProvider. Setiap penyedia OneGet dirancang untuk berinteraksi dengan jenis repositori tertentu. Misalnya, penyedia NuGet dirancang untuk berinteraksi dengan repositori berbasis NuGet. Jika penyedia OneGet tidak ditentukan selama pendaftaran, PowerShellGet mencoba menemukan penyedia OneGet yang dapat menangani lokasi sumber yang ditentukan.
Contoh
Contoh 1: Mendaftarkan repositori
$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
Perintah pertama mendaftarkan https://www.myget.org/F/mypsrepository/ sebagai repositori untuk pengguna saat ini. Setelah myNuGetSource terdaftar, Anda dapat secara eksplisit mereferensikannya saat mencari, menginstal, dan menerbitkan modul. Karena parameter PackageManagementProvider tidak ditentukan, repositori tidak secara eksplisit dikaitkan dengan penyedia paket OneGet, sehingga powerShellGet polling penyedia paket yang tersedia dan mengaitkannya dengan penyedia NuGet.
Perintah kedua mendapatkan repositori terdaftar dan menampilkan hasilnya.
Parameter
-Credential
Menentukan kredensial akun yang memiliki hak untuk mendaftarkan repositori.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Default
Parameter digunakan untuk mendaftarkan PSGallery. Anda hanya perlu melakukan ini jika Anda menghapus repositori PSGallery .
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
PSGalleryParameterSet
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-InstallationPolicy
Menentukan kebijakan penginstalan. Nilai yang valid adalah: Tepercaya, Tidak Tepercaya. Nilai defaultnya adalah Tidak Tepercaya.
Kebijakan penginstalan repositori menentukan perilaku PowerShell saat menginstal dari repositori tersebut. Saat menginstal modul dari repositori UnTrusted, pengguna diminta untuk konfirmasi.
Anda dapat mengatur InstallationPolicy dengan Set-PSRepository cmdlet.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Nilai yang diterima: | Trusted, Untrusted |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan nama repositori yang akan didaftarkan. Anda dapat menggunakan nama ini untuk menentukan repositori dalam cmdlet seperti Find-Module dan Install-Module.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-PackageManagementProvider
Menentukan penyedia paket OneGet. Jika Anda tidak menentukan nilai untuk parameter ini, PowerShellGet polling penyedia paket yang tersedia dan mengaitkan repositori ini dengan penyedia paket pertama yang menunjukkan dapat menangani repositori.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Proxy
Menentukan server proksi untuk permintaan, daripada menyambungkan langsung ke sumber daya Internet.
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-ProxyCredential
Menentukan akun pengguna yang memiliki izin untuk menggunakan server proksi yang ditentukan oleh parameter Proksi .
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-PublishLocation
Menentukan URI lokasi penerbitan untuk modul. Misalnya, untuk repositori berbasis NuGet, lokasi penerbitan mirip https://someNuGetUrl.com/api/v2/packagedengan .
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ScriptPublishLocation
Menentukan URI lokasi penerbitan untuk skrip. Misalnya, untuk repositori berbasis NuGet, lokasi penerbitan mirip https://someNuGetUrl.com/api/v2/package/dengan .
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ScriptSourceLocation
Menentukan URI untuk menemukan dan menginstal skrip dari repositori ini. URI dapat berupa umpan server NuGet (situasi paling umum), HTTP, HTTPS, FTP, atau lokasi file.
Misalnya, untuk repositori berbasis NuGet, lokasi sumber mirip https://someNuGetUrl.com/api/v2/items/psscriptdengan .
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-SourceLocation
Menentukan URI untuk menemukan dan menginstal modul dari repositori ini. URI dapat berupa umpan server NuGet (situasi paling umum), HTTP, HTTPS, FTP, atau lokasi file.
Misalnya, untuk repositori berbasis NuGet, lokasi sumber mirip https://someNuGetUrl.com/api/v2dengan .
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NameParameterSet
| Position: | 1 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
PSCredential
Uri
Output
Object
Catatan
Penting
Pada April 2020, Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Untuk informasi selengkapnya, lihat pengumuman
