Install-PSResource
Menginstal sumber daya dari repositori terdaftar.
Sintaks
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>]
Install-PSResource
[-Repository <String[]>]
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
[-InputObject] <PSResourceInfo[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PSResource
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
-RequiredResourceFile <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-PSResource
[-Credential <PSCredential>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Reinstall]
[-Quiet]
[-AcceptLicense]
[-NoClobber]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-PassThru]
-RequiredResource <Object>
[-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 Install-Module
cmdlet 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.
Contoh
Contoh 1
Menginstal versi stabil terbaru (non-prarilis) dari modul Az .
Install-PSResource Az
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.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
Memvalidasi tanda tangan Authenticode dan file katalog di Windows.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Aliases: | cf |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Kredensial opsional yang digunakan saat mengakses repositori.
Jenis: | PSCredential |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Digunakan untuk input alur.
Jenis: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nama satu atau beberapa sumber daya untuk diinstal.
Jenis: | String[] |
Position: | 0 |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
Mencegah penginstalan paket yang berisi cmdlet yang sudah ada pada komputer.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Saat ditentukan, output objek PSResourceInfo untuk sumber daya yang disimpan.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Jika ditentukan, sertakan versi prarilis dalam hasil pencarian yang dikembalikan.
Jenis: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
Menekan bilah kemajuan penginstalan.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Jenis: | String[] |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-RequiredResource
String hashtable atau JSON yang menentukan sumber daya yang akan diinstal. Karakter kartubebas tidak diperbolehkan. Lihat bagian CATATAN untuk deskripsi format file.
Jenis: | Object |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Menginstal CurrentUser
modul di lokasi yang hanya dapat diakses oleh pengguna komputer saat ini. Contohnya:
$home\Documents\PowerShell\Modules
Jenis: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
nilai yang diterima: | CurrentUser, AllUsers |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustRepository
Tekan perintah untuk mempercayai repositori. Perintah untuk mempercayai repositori hanya terjadi jika repositori tidak dikonfigurasi sebagai tepercaya.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 yang tercantum dalam dokumentasi rentang versi NuGet. Menggunakan 1.0.0.0
karena 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.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Aliases: | wi |
Position: | Named |
nilai default: | False |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
String[]
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 .psd1
file dan objek JSON disimpan dalam .json
file. Untuk informasi selengkapnya, lihat about_PSResourceGet.
Link Terkait
PSResourceGet
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk