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
Update-Module Cmdlet 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.
Ini adalah cmdlet proksi untuk Update-PSResource cmdlet di Microsoft.PowerShell.PSResourceGet. Untuk informasi selengkapnya, lihat Update-PSResource.
Contoh
Contoh 1: Memperbarui semua modul
Contoh ini memperbarui semua modul yang diinstal ke versi terbaru di galeri online.
Update-ModuleContoh 2: Memperbarui modul berdasarkan nama
Contoh ini memperbarui modul tertentu ke versi terbaru di galeri online.
Update-Module -Name SpeculationControlUpdate-Module menggunakan parameter Nama untuk memperbarui modul tertentu, SpeculationControl.
Contoh 3: Menampilkan 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.14Update-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 Force akan menginstal ulang modul.
Update-Module -Name SpeculationControl -ForceUpdate-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrerelease
Memungkinkan Anda memperbarui modul dengan modul yang lebih baru yang ditandai sebagai prarilis.
Cmdlet proksi memetakan parameter ini ke parameter Prarilis dari Update-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan Update-Module.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | 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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Memaksa pembaruan dari setiap modul yang ditentukan tanpa permintaan untuk meminta konfirmasi. Jika modul sudah diinstal, Paksa instal ulang modul.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Update-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Menentukan nama satu atau beberapa modul yang akan diperbarui. Update-Module mencari $env:PSModulePath 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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-PassThru
Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh Update-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh Update-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Update-PSResource
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
String[]
Output
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.
Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Anda harus menggunakan TLS 1.2 atau yang lebih tinggi. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
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 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.
Link Terkait
PSResourceGet
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk