Update-Module

Modul:

PowerShellGet Module

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

Sintaks

All

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. Pembaruan hanya diinstal untuk modul yang diinstal di komputer lokal dengan Install-Module. Update-Module mencari $env:PSModulePath modul yang 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 menggunakan parameter RequiredVersion .

Parameter yang mengambil nomor versi modul mengharapkan string yang diformat sebagai nomor versi.

• Nomor versi standar memiliki format di x.y.z mana x, y, dan z adalah angka
• Versi prarilis memiliki format x.y.z-<prerelease_label> di mana string arbitrer ditetapkan ke rilis tersebut <prerelease_label> .

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

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'".

menggunakan tampilan parameter WhatIf apa yang akan terjadi jika 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

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 Force menginstal ulang modul.

Update-Module -Name SpeculationControl -Force

menggunakan parameter Nama untuk menentukan modul, SpeculationControl. Parameter Force memperbarui modul tanpa meminta konfirmasi pengguna.

Parameter

-AcceptLicense

Terima perjanjian lisensi secara otomatis selama penginstalan jika paket memerlukannya.

Properti parameter

Jenis:	SwitchParameter
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

-AllowPrerelease

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

Properti parameter

Jenis:	SwitchParameter
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

-Confirm

Meminta konfirmasi sebelum menjalankan Update-Module.

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

Menentukan akun pengguna yang memiliki izin untuk memperbarui modul.

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

-Force

Memaksa pembaruan dari setiap modul yang ditentukan tanpa permintaan untuk meminta konfirmasi. Jika modul sudah diinstal, Force menginstal ulang modul.

Properti parameter

Jenis:	SwitchParameter
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

-MaximumVersion

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

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

-Name

Menentukan nama satu atau beberapa modul yang akan diperbarui. Update-Module mencari $env:PSModulePath agar modul diperbarui. Jika tidak ada kecocokan yang ditemukan di $env:PSModulePath untuk nama modul yang ditentukan, kesalahan 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.

Properti parameter

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

Kumpulan parameter

(All)

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

-PassThru

Mengembalikan objek yang mewakili item dengan mana Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Properti parameter

Jenis:	SwitchParameter
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

-Proxy

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

Properti parameter

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

-ProxyCredential

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

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

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

Properti parameter

Jenis:	String
Nilai default:	CurrentUser
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

-WhatIf

Menunjukkan apa yang akan terjadi jika Update-Module 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

PSCredential

Uri

Output

Object

Catatan

PowerShell menyertakan alias berikut untuk Update-Module:

• Semua platform:
  • upmo

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, Galeri PowerShell 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 yang lebih baru rilis PowerShell, pada Windows 7 atau Windows 2008 R2 dan rilis Windows yang lebih baru.

Jika modul yang Anda tentukan dengan parameter Nama tidak diinstal 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 kembali Update-Module setelah proses dihentikan.

Link Terkait

• Find-Module
• Get-InstalledModule
• Install-Module
• Publish-Module
• Uninstall-Module