Update-Module

Mengunduh dan menginstal versi terbaru modul yang ditentukan dari galeri online ke komputer lokal.

Sintaks

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <String>]
      [-MaximumVersion <String>]
      [-Credential <PSCredential>]
      [-Scope <String>]
      [-Proxy <Uri>]
      [-ProxyCredential <PSCredential>]
      [-Force]
      [-AllowPrerelease]
      [-AcceptLicense]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet Update-Module menginstal versi terbaru modul dari galeri online. Anda diminta untuk mengonfirmasi pembaruan sebelum diinstal. Updates hanya diinstal untuk modul yang diinstal di komputer lokal dengan Install-Module. Update-Module mencari modul yang $env:PSModulePath diinstal.

Update-Module tanpa parameter yang ditentukan memperbarui semua modul yang diinstal. Untuk menentukan modul yang akan diperbarui, gunakan parameter Nama . Anda dapat memperbarui ke versi spesifik modul dengan menggunakan parameter RequiredVersion .

Jika modul yang diinstal sudah menjadi versi terbaru, modul tidak diperbarui. Jika modul tidak ditemukan di $env:PSModulePath, kesalahan akan ditampilkan.

Untuk menampilkan modul yang diinstal, gunakan Get-InstalledModule.

Contoh

Contoh 1: Memperbarui semua modul

Contoh ini memperbarui semua modul yang diinstal ke versi terbaru di galeri online.

Update-Module

Contoh 2: Memperbarui modul berdasarkan nama

Contoh ini memperbarui modul tertentu ke versi terbaru di galeri online.

Update-Module -Name SpeculationControl

Update-Module menggunakan parameter Nama untuk memperbarui modul tertentu, SpeculationControl.

Contoh 3: Melihat eksekusi Update-Module bagaimana-jika

Contoh ini melakukan skenario bagaimana-jika untuk menunjukkan apa yang terjadi jika Update-Module dijalankan. Perintah tidak dijalankan.

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module menggunakan parameter WhatIf menampilkan apa yang akan terjadi jika Update-Module dijalankan.

Contoh 4: Memperbarui modul ke versi tertentu

Dalam contoh ini, modul diperbarui ke versi tertentu. Versi harus ada di galeri online atau kesalahan ditampilkan.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module menggunakan parameter Nama untuk menentukan modul, SpeculationControl. Parameter RequiredVersion menentukan versi, 1.0.14.

Contoh 5: Memperbarui modul tanpa konfirmasi

Contoh ini tidak meminta konfirmasi untuk memperbarui modul ke versi terbaru dari galeri online. Jika modul sudah diinstal, parameter Paksa akan menginstal ulang modul.

Update-Module -Name SpeculationControl -Force

Update-Module menggunakan parameter Nama untuk menentukan modul, SpeculationControl. Parameter Paksa memperbarui modul tanpa meminta konfirmasi pengguna.

Parameter

-AcceptLicense

Terima perjanjian lisensi secara otomatis selama penginstalan jika paket memerlukannya.

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

-AllowPrerelease

Memungkinkan Anda memperbarui modul dengan modul yang lebih baru yang ditandai sebagai prarilis.

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

-Confirm

Meminta konfirmasi sebelum menjalankan Update-Module.

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

-Credential

Menentukan akun pengguna yang memiliki izin untuk memperbarui modul.

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

-Force

Memaksa pembaruan setiap modul yang ditentukan tanpa permintaan untuk meminta konfirmasi. Jika modul sudah diinstal, Paksa instal ulang modul.

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

-MaximumVersion

Menentukan versi maksimum dari satu modul untuk diperbarui. Anda tidak dapat menambahkan parameter ini jika Anda mencoba memperbarui beberapa modul. Parameter MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

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

-Name

Menentukan nama satu atau beberapa modul yang akan diperbarui. Update-Module$env:PSModulePath mencari modul yang akan diperbarui. Jika tidak ada kecocokan yang ditemukan untuk $env:PSModulePath nama modul yang ditentukan, kesalahan akan terjadi.

Kartubebas diterima dalam nama modul. Jika Anda menambahkan karakter kartubebas ke nama yang ditentukan dan tidak ada kecocokan yang ditemukan, tidak ada kesalahan yang terjadi.

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

-PassThru

Mengembalikan objek yang mewakili item yang sedang Anda kerjakan. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:True
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
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Menentukan versi yang tepat di mana modul yang terinstal yang ada akan diperbarui. Versi yang ditentukan oleh RequiredVersion harus ada di galeri online atau kesalahan ditampilkan. Jika lebih dari satu modul diperbarui dalam satu perintah, Anda tidak dapat menggunakan RequiredVersion.

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

-Scope

Menentukan cakupan penginstalan modul. Nilai yang dapat diterima untuk parameter ini adalah AllUsers dan CurrentUser. Jika Cakupan tidak ditentukan, pembaruan diinstal dalam cakupan CurrentUser .

Cakupan AllUsers memerlukan izin yang ditingkatkan dan menginstal modul di lokasi yang dapat diakses oleh semua pengguna komputer:

$env:ProgramFiles\PowerShell\Modules

CurrentUser tidak memerlukan izin yang ditingkatkan dan menginstal modul di lokasi yang hanya dapat diakses oleh pengguna komputer saat ini:

$home\Documents\PowerShell\Modules

Saat tidak ada Cakupan yang ditentukan, default diatur berdasarkan versi PowerShellGet.

  • Di PowerShellGet versi 2.0.0 ke atas, defaultnya adalah CurrentUser, yang tidak memerlukan elevasi untuk penginstalan.
  • Dalam versi PowerShellGet 1.x, defaultnya adalah AllUsers, yang memerlukan elevasi untuk penginstalan.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika Update-Module berjalan. Cmdlet tidak dijalankan.

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

Input

String[]

String

PSCredential

Uri

Output

Object

Catatan

Untuk PowerShell versi 6.0 ke atas, cakupan penginstalan default selalu CurrentUser. Pembaruan modul untuk CurrentUser, $home\Documents\PowerShell\Modules, tidak memerlukan izin yang ditingkatkan. Pembaruan modul untuk AllUsers, $env:ProgramFiles\PowerShell\Modules, memerlukan izin yang ditingkatkan.

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.

Update-Module berjalan pada PowerShell 3.0 atau rilis PowerShell yang lebih baru, pada Windows 7 atau Windows 2008 R2 dan rilis Windows yang lebih baru.

Jika modul yang Anda tentukan dengan parameter Nama tidak diinstal dengan menggunakan Install-Module, kesalahan terjadi.

Anda hanya dapat menjalankan Update-Module pada modul yang Anda instal dari galeri online dengan menjalankan Install-Module.

Jika Update-Module mencoba memperbarui biner yang sedang digunakan, Update-Module mengembalikan kesalahan yang mengidentifikasi proses masalah. Pengguna diinformasikan untuk mencoba Update-Module kembali setelah proses dihentikan.