Install-PSResource

  • Referensi
Modul:
Microsoft.PowerShell.PSResourceGet

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 permintaan lisensi.

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

Contoh

Contoh 1

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

Install-PSResource Az

Contoh 2

Menginstal modul Az stabil terbaru di 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 . Ketika 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.

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

-AuthenticodeCheck

Memvalidasi tanda tangan Authenticode dan file katalog di Windows.

Type:SwitchParameter
Position:Named
Default value:False
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

Kredensial opsional yang digunakan saat mengakses repositori.

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

-InputObject

Digunakan untuk input alur.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nama satu atau beberapa sumber daya untuk diinstal.

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

-NoClobber

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

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

-PassThru

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

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

-Prerelease

Ketika ditentukan, menyertakan versi prarilis dalam hasil pencarian yang dikembalikan.

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

-Quiet

Menekan bilah kemajuan penginstalan.

Type:SwitchParameter
Position:Named
Default value:False
Required: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 penginstalan modul yang rusak.

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

Type:SwitchParameter
Position:Named
Default value:False
Required: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.

Type:String[]
Position:Named
Default value:None
Required: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.

Type:Object
Position:Named
Default value:None
Required: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.

Type:String
Position:Named
Default value:None
Required: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
Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

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

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

-TemporaryPath

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

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

-TrustRepository

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

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

-Version

Menentukan versi sumber daya yang akan dikembalikan. Nilai dapat menjadi versi yang tepat atau rentang versi 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 sebagai versi tidak menghasilkan versi 1.0.0.0 dan yang lebih tinggi (rentang inklusif minimum). Sebaliknya, nilai dianggap sebagai versi yang diperlukan. Untuk mencari rentang inklusif minimum, gunakan [1.0.0.0, ] sebagai rentang versi.

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

-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

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 .psd1 file dan objek JSON disimpan dalam .json file. Untuk informasi selengkapnya, lihat about_PSResourceGet.