Update-Module

Belirtilen modüllerin en yeni sürümünü çevrimiçi bir galeriden yerel bilgisayara indirip yükler.

Syntax

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

Description

cmdlet'i Update-Module çevrimiçi bir galeriden modülün en yeni sürümünü yükler. Güncelleştirme yüklenmeden önce onaylamanız istenir. Güncelleştirmeler yalnızca ile Install-Moduleyerel bilgisayarda yüklü olan modüller için yüklenir. Update-Module$env:PSModulePath yüklü modülleri arar.

Bu, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Update-PSResource bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Update-PSResource.

Örnekler

Örnek 1: Tüm modülleri güncelleştirme

Bu örnek, tüm yüklü modülleri çevrimiçi galerideki en yeni sürüme güncelleştirir.

Update-Module

Örnek 2: Modülü ada göre güncelleştirme

Bu örnek, belirli bir modülü çevrimiçi galerideki en yeni sürüme güncelleştirir.

Update-Module -Name SpeculationControl

Update-ModuleBelirli bir modül olan SpeculationControl'u güncelleştirmek için Name parametresini kullanır.

Örnek 3: Durum Update-Module çalıştırmalarını görüntüleme

Bu örnek, çalıştırıldığında ne olacağını Update-Module göstermek için bir durum senaryosu yapar. Komut çalıştırılmıyor.

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çalıştırıldığında Update-Module ne olacağını gösteren WhatIf parametresini kullanır.

Örnek 4: Modülü belirtilen bir sürüme güncelleştirme

Bu örnekte, bir modül belirli bir sürüme güncelleştirildi. Sürüm çevrimiçi galeride mevcut olmalıdır veya bir hata görüntülenir.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module, SpeculationControl modülünü belirtmek için Name parametresini kullanır. RequiredVersion parametresi 1.0.14 sürümünü belirtir.

Örnek 5: Modülü onaylamadan güncelleştirme

Bu örnek, modülü çevrimiçi bir galeriden en yeni sürüme güncelleştirmek için onay isteğinde bulunmaz. Modül zaten yüklüyse Force parametresi modülü yeniden yükler.

Update-Module -Name SpeculationControl -Force

Update-Module, SpeculationControl modülünü belirtmek için Name parametresini kullanır. Force parametresi, kullanıcı onayı istemeden modülü güncelleştirir.

Parametreler

-AcceptLicense

Paket gerektiriyorsa, yükleme sırasında lisans sözleşmesini otomatik olarak kabul edin.

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

-AllowPrerelease

Bir modülü, ön sürüm olarak işaretlenmiş yeni modülle güncelleştirmenize olanak tanır.

Proxy cmdlet'i bu parametreyi ön sürüm parametresiyle eşler Update-PSResource.

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

-Confirm

çalıştırmadan Update-Moduleönce sizden onay ister.

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

-Credential

Modülü güncelleştirme izni olan bir kullanıcı hesabını belirtir.

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

-Force

Onay isteğinde bulunmadan belirtilen her modülün güncelleştirmesini zorlar. Modül zaten yüklüyse , Zorla modülü yeniden yükler.

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

-MaximumVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleUpdate-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-Name

Güncelleştirilecek bir veya daha fazla modülün adını belirtir. Update-Module$env:PSModulePath güncelleştirilecek modülleri arar. Belirtilen modül adı için içinde $env:PSModulePath eşleşme bulunmazsa bir hata oluşur.

Modül adlarında joker karakterler kabul edilir. Belirtilen ada joker karakter eklerseniz ve eşleşme bulunmazsa hata oluşmaz.

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

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak bu cmdlet herhangi bir çıktı üretmez.

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

-Proxy

proxy cmdlet'i tarafından Update-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

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

-ProxyCredential

proxy cmdlet'i tarafından Update-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

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

-RequiredVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleUpdate-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-Scope

Modülün yükleme kapsamını belirtir. Bu parametre için kabul edilebilir değerler AllUsers ve CurrentUser'dır. Kapsam belirtilmezse güncelleştirme CurrentUser kapsamına yüklenir.

AllUsers kapsamı yükseltilmiş izinler gerektirir ve modülleri bilgisayarın tüm kullanıcıları tarafından erişilebilen bir konuma yükler:

$env:ProgramFiles\PowerShell\Modules

CurrentUser yükseltilmiş izinler gerektirmez ve modülleri yalnızca bilgisayarın geçerli kullanıcısı tarafından erişilebilen bir konuma yükler:

$HOME\Documents\PowerShell\Modules

Hiçbir Kapsam tanımlanmadığında, varsayılan değer PowerShellGet sürümüne göre ayarlanır.

  • PowerShellGet 2.0.0 ve üzeri sürümlerde varsayılan değer CurrentUser'dır ve yükleme için yükseltme gerektirmez.
  • PowerShellGet 1.x sürümlerinde varsayılan değer, yükleme için yükseltme gerektiren AllUsers'dır.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Çalıştırılırsa Update-Module ne olacağını gösterir. Cmdlet çalıştırılmıyor.

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

Girişler

String[]

String

PSCredential

Uri

Çıkışlar

Object

Notlar

PowerShell, için Update-Moduleaşağıdaki diğer adları içerir:

  • Tüm platformlar:
    • upmo

PowerShell sürüm 6.0 ve üzeri için varsayılan yükleme kapsamı her zaman CurrentUser'dır. CurrentUser, $HOME\Documents\PowerShell\Modulesiçin modül güncelleştirmelerinin yükseltilmiş izinlere ihtiyacı yoktur. AllUsers, $env:ProgramFiles\PowerShell\Modulesiçin modül güncelleştirmeleri yükseltilmiş izinlere ihtiyaç duyar.

PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmanız gerekir. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Update-Module , Windows 7 veya Windows 2008 R2 ve sonraki Windows sürümlerinde PowerShell'in PowerShell 3.0 veya sonraki sürümlerinde çalışır.

Name parametresiyle belirttiğiniz modül kullanılarak Install-Moduleyüklenmediyse bir hata oluşur.

Yalnızca komutunu çalıştırarak Install-Moduleçevrimiçi galeriden yüklediğiniz modüllerde çalıştırabilirsinizUpdate-Module.

Update-Module Kullanımda olan ikili dosyaları güncelleştirmeye çalışırsa, Update-Module sorun işlemlerini tanımlayan bir hata döndürür. İşlemler durdurulduktan sonra kullanıcıya yeniden denemesi Update-Module bildirilir.