Install-PSResource

Modul:

Microsoft.PowerShell.PSResourceGet Module

Menginstal sumber daya dari repositori terdaftar.

Sintaks

NameParameterSet (Default)

Install-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Install-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet ini menginstal sumber daya dari repositori terdaftar ke jalur penginstalan pada komputer. Secara default, cmdlet tidak mengembalikan objek apa pun. Parameter lain memungkinkan Anda menentukan repositori, cakupan, dan versi untuk sumber daya, dan menekan perintah lisensi.

Cmdlet ini menggabungkan fungsi cmdlet Install-Module dan Install-Script dari PowerShellGet v2.

Install-PSResource tidak memuat modul yang baru diinstal ke dalam sesi saat ini. Anda harus mengimpor versi baru atau memulai sesi baru untuk menggunakan modul yang diperbarui. Untuk informasi selengkapnya, lihat Import-Module .

Nota

Install-PSResource tidak menginstal sumber daya dependen dari repositori yang menggunakan protokol NuGet v3. Anda harus menginstal sumber daya dependen satu per satu. Kami berniat untuk menambahkan fitur ini dalam rilis mendatang.

Contoh

Contoh 1

Menginstal versi stabil terbaru (non-prarilis) modul Az dari Galeri PowerShell.

Install-PSResource Az -Repository PSGallery

Modul Az adalah meta-modul yang mencakup semua modul Az PowerShell sebagai dependensi. Perintah ini menginstal modul Az dan semua dependensinya.

Contoh 2

Menginstal modul Az stabil terbaru dalam antara versi 7.3.0 dan 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Contoh 3

Menginstal versi stabil terbaru modul Az. Saat parameter Instal Ulang digunakan, cmdlet menulis melalui versi yang diinstal sebelumnya.

Install-PSResource Az -Reinstall

Contoh 4

Menginstal PSResources yang ditentukan dalam file psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Contoh 5

Menginstal PSResources yang ditentukan dalam hashtable.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parameter

-AcceptLicense

Menentukan bahwa sumber daya harus menerima permintaan apa pun untuk menerima perjanjian lisensi. Ini menekan permintaan jika modul mengamanatkan bahwa pengguna menerima perjanjian lisensi.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-AuthenticodeCheck

Memvalidasi tanda tangan Authenticode dan file katalog di Windows.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Credential

Kredensial opsional yang digunakan saat mengakses repositori.

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:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Digunakan untuk input alur.

Properti parameter

Jenis:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Sumber Daya Induk

Kumpulan parameter

InputObjectParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Name

Nama satu atau beberapa sumber daya untuk diinstal.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-NoClobber

Mencegah penginstalan paket yang berisi cmdlet yang sudah ada pada komputer.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-PassThru

Jika ditentukan, menghasilkan objek PSResourceInfo untuk sumber daya yang disimpan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Prerelease

Jika ditentukan, sertakan versi prarilis dalam hasil pencarian yang dikembalikan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	IsPrarilis

Kumpulan parameter

NameParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Quiet

Menekan bilah kemajuan penginstalan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Reinstall

Menginstal versi terbaru modul meskipun versi terbaru sudah diinstal. Versi yang diinstal ditimpa. Ini memungkinkan Anda untuk memperbaiki instalasi modul yang rusak.

Jika versi modul yang lebih lama diinstal, versi baru diinstal berdampingan di folder khusus versi baru.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Repository

Menentukan satu atau beberapa nama repositori untuk dicari. Jika tidak ditentukan, pencarian mencakup semua repositori terdaftar, dalam urutan prioritas (tertinggi terlebih dahulu), hingga repositori ditemukan yang berisi paket. Repositori diurutkan berdasarkan prioritas, lalu berdasarkan nama. Nilai Prioritas yang lebih rendah memiliki prioritas yang lebih tinggi.

Saat mencari sumber daya di beberapa repositori, cmdlet PSResourceGet mencari repositori menggunakan urutan pengurutan ini. Install-PSResource menginstal paket pencocokan pertama dari daftar repositori yang diurutkan.

Parameter mendukung karakter kartubebas *. Jika Anda menentukan beberapa repositori, semua nama harus menyertakan atau menghilangkan karakter kartubebas. Anda tidak dapat menentukan campuran nama dengan dan tanpa kartubebas.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	True
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

InputObjectParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-RequiredResource

String hashtable atau JSON yang menentukan sumber daya yang akan diinstal. Karakter kartubebas tidak diperbolehkan. Lihat bagian CATATAN untuk deskripsi format file.

Properti parameter

Jenis:	Object
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

RequiredResourceParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-RequiredResourceFile

Jalur ke .psd1 atau .json yang menentukan sumber daya yang akan diinstal. Karakter kartubebas tidak diperbolehkan. Lihat bagian CATATAN untuk deskripsi format file.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

RequiredResourceFileParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Scope

Menentukan cakupan penginstalan. Nilai yang diterima adalah:

• CurrentUser
• AllUsers

Cakupan default adalah CurrentUser, yang tidak memerlukan elevasi untuk penginstalan.

Cakupan AllUsers menginstal modul di lokasi yang dapat diakses oleh semua pengguna komputer. Contohnya:

• $env:ProgramFiles\PowerShell\Modules

CurrentUser menginstal modul di lokasi yang hanya dapat diakses oleh pengguna komputer saat ini. Contohnya:

• $home\Documents\PowerShell\Modules

Properti parameter

Jenis:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Nilai default:	None
Nilai yang diterima:	CurrentUser, AllUsers
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

-SkipDependencyCheck

Lewati pemeriksaan dependensi sumber daya. Hanya sumber daya yang ditemukan yang terinstal. Tidak ada sumber daya dari sumber daya yang ditemukan yang diinstal.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-TemporaryPath

Menentukan jalur untuk menginstal sumber daya untuk sementara sebelum penginstalan aktual. Jika tidak ada jalur sementara yang disediakan, sumber daya untuk sementara diinstal di folder sementara pengguna saat ini.

Properti parameter

Jenis:	String
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:	False
Nilai dari argumen yang tersisa:	False

-TrustRepository

Tekan perintah untuk mempercayai repositori. Perintah untuk mempercayai repositori hanya terjadi jika repositori tidak dikonfigurasi sebagai tepercaya.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
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

-Version

Menentukan versi sumber daya yang akan dikembalikan. Nilainya dapat berupa versi atau rentang versi yang tepat menggunakan sintaks penerapan versi NuGet.

Untuk informasi selengkapnya tentang rentang versi NuGet, lihat penerapan versi Paket .

PowerShellGet mendukung semua kecuali versi inklusif minimum tercantum dalam dokumentasi rentang versi NuGet. Menggunakan 1.0.0.0 sebagai versi tidak menghasilkan versi 1.0.0.0 dan yang lebih tinggi (rentang inklusif minimum). Sebagai gantinya, nilai dianggap sebagai versi yang diperlukan. Untuk mencari rentang inklusif minimum, gunakan [1.0.0.0, ] sebagai rentang versi.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	True
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

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
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

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Secara default, cmdlet tidak mengembalikan objek apa pun. Saat parameter PassThru digunakan, cmdlet menghasilkan objek PSResourceInfo untuk sumber daya yang disimpan.

Catatan

Modul mendefinisikan isres sebagai alias untuk Install-PSResource.

Parameter RequiredResource dan RequiredResourceFile digunakan untuk menemukan objek PSResource yang cocok dengan kriteria tertentu. Anda dapat menentukan kriteria pencarian menggunakan hashtable atau objek JSON. Untuk parameter RequiredResourceFile, hashtable disimpan dalam file dan objek JSON disimpan dalam file . Untuk informasi selengkapnya, lihat about_PSResourceGet.

Link Terkait

• Penerapan versi paket
• Uninstall-PSResource