Install-PackageProvider

Menginstal satu atau beberapa penyedia paket Manajemen Paket.

Sintaks

Install-PackageProvider
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Source <String[]>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PackageProvider
       [-Scope <String>]
       [-InputObject] <SoftwareIdentity[]>
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Deskripsi

Install-PackageProvider Cmdlet menginstal penyedia Manajemen Paket yang cocok yang tersedia di sumber paket yang terdaftar di PowerShellGet. Secara default, ini termasuk modul yang tersedia di galeri Windows PowerShell dengan tag PackageManagement. Penyedia Manajemen Paket PowerShellGet digunakan untuk menemukan penyedia di repositori ini.

Cmdlet ini juga menginstal penyedia Manajemen Paket yang cocok yang tersedia menggunakan aplikasi bootstrapping Manajemen Paket.

Cmdlet ini juga menginstal penyedia Manajemen Paket yang cocok yang tersedia di penyimpanan Package Management Azure Blob. Gunakan penyedia bootstrapper untuk menemukan dan menginstalnya.

Untuk mengeksekusi pertama kalinya, PackageManagement memerlukan koneksi internet untuk mengunduh penyedia paket NuGet. Namun, jika komputer Anda tidak memiliki koneksi internet dan Anda perlu menggunakan penyedia NuGet atau PowerShellGet, Anda dapat mengunduhnya di komputer lain dan menyalinnya ke komputer target Anda. Gunakan langkah-langkah berikut untuk melakukan ini:

  1. Jalankan Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force untuk menginstal penyedia dari komputer dengan koneksi internet.
  2. Setelah penginstalan, Anda dapat menemukan penyedia yang terinstal di $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> atau $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. Tempatkan <ProviderName> folder, yang dalam hal ini adalah folder NuGet, di lokasi yang sesuai di komputer target Anda. Jika komputer target Anda adalah server Nano, Anda perlu menjalankan Install-PackageProvider dari Nano Server untuk mengunduh biner NuGet yang benar.
  4. Mulai ulang PowerShell untuk memuat penyedia paket secara otomatis. Atau, jalankan Get-PackageProvider -ListAvailable untuk mencantumkan semua penyedia paket yang tersedia di komputer. Kemudian gunakan Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 untuk mengimpor penyedia ke sesi Windows PowerShell saat ini.

Contoh

Contoh 1: Menginstal penyedia paket dari Galeri PowerShell

Perintah ini menginstal penyedia paket GistProvider dari Galeri PowerShell.

Install-PackageProvider -Name "GistProvider" -Verbose

Contoh 2: Menginstal versi penyedia paket tertentu

Contoh ini menginstal versi tertentu dari penyedia paket NuGet.

Perintah pertama menemukan semua versi penyedia paket bernama NuGet. Perintah kedua menginstal versi penyedia paket NuGet yang ditentukan.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Contoh 3: Temukan penyedia dan instal

Contoh ini menggunakan Find-PackageProvider dan alur untuk mencari penyedia Gist dan menginstalnya.

Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose

Contoh 4: Menginstal penyedia ke folder modul pengguna saat ini

Perintah ini menginstal penyedia paket sehingga $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies hanya pengguna saat ini yang dapat menggunakannya.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parameter

-AllVersions

Menunjukkan bahwa cmdlet ini menginstal semua versi penyedia paket yang tersedia. Secara default, Install-PackageProvider hanya mengembalikan versi tertinggi yang tersedia.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Menentukan akun pengguna yang memiliki izin untuk menginstal penyedia paket.

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

-Force

Menunjukkan bahwa cmdlet ini memaksa semua tindakan dengan cmdlet ini yang dapat dipaksa. Saat ini, ini berarti parameter Force bertindak sama dengan parameter ForceBootstrap .

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

-ForceBootstrap

Menunjukkan bahwa cmdlet ini secara otomatis menginstal penyedia paket.

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

-InputObject

Menentukan objek SoftwareIdentity . Find-PackageProvider Gunakan cmdlet untuk mendapatkan objek SoftwareIdentity untuk disalurkan ke dalam Install-PackageProvider.

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Menentukan versi maksimum yang diizinkan dari penyedia paket yang ingin Anda instal. Jika Anda tidak menambahkan parameter ini, Install-PackageProvider instal versi penyedia tertinggi yang tersedia.

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

-MinimumVersion

Menentukan versi minimum yang diizinkan dari penyedia paket yang ingin Anda instal. Jika Anda tidak menambahkan parameter ini, Install-PackageProvider instal versi tertinggi yang tersedia dari paket yang juga memenuhi persyaratan apa pun yang ditentukan oleh parameter MaximumVersion .

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

-Name

Menentukan satu atau beberapa nama modul penyedia paket. Pisahkan beberapa nama paket dengan koma. Karakter kartubebas tidak didukung.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Menentukan server proksi untuk permintaan tersebut, daripada menyambungkan langsung ke sumber daya Internet.

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

-ProxyCredential

Menentukan akun pengguna yang memiliki izin untuk menggunakan server proksi yang ditentukan oleh parameter Proksi .

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

-RequiredVersion

Menentukan versi penyedia paket yang diperbolehkan yang tepat yang ingin Anda instal. Jika Anda tidak menambahkan parameter ini, Install-PackageProvider instal versi penyedia dengan ketersediaan tertinggi yang juga memenuhi versi maksimum yang ditentukan oleh parameter MaximumVersion .

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

-Scope

Menentukan cakupan penginstalan penyedia. Nilai yang dapat diterima untuk parameter ini adalah:

  • AllUsers - menginstal penyedia di lokasi yang dapat diakses oleh semua pengguna komputer. Secara default, ini adalah $env:ProgramFiles\PackageManagement\ProviderAssemblies.

  • CurrentUser - menginstal penyedia di lokasi di mana mereka hanya dapat diakses oleh pengguna saat ini. Secara default, ini adalah $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

Menentukan satu atau beberapa sumber paket. Get-PackageSource Gunakan cmdlet untuk mendapatkan daftar sumber paket yang tersedia.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Menunjukkan yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Anda dapat menyalurkan objek SoftwareIdentity ke cmdlet ini. Gunakan Find-PackageProvider untuk mendapatkan objek SoftwareIdentity yang dapat disalurkan ke dalam Install-PackageProvider.

Catatan

Penting

Pada April 2020, PowerShell Gallery 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 di blog PowerShell.