Update-Module

Modul:

PowerShellGet v3 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.

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-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

Set 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.

Cmdlet proksi memetakan parameter ini ke parameter Prarilis dari Update-PSResource.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set 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

Set 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

Set 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

Set parameter

(All)

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

-MaximumVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Update-PSResource

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set 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

Set 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

Set parameter

(All)

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

-Proxy

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh Update-PSResource.

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

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

-ProxyCredential

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh Update-PSResource.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

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

-RequiredVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Update-PSResource

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set 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

Set 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

Set 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.

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 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