Bagikan melalui

Update-Module

  • Referensi
Modul:
PowerShellGet

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-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: 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.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 Force 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
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[]

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