Update-Module
Belirtilen modüllerin en yeni sürümünü çevrimiçi bir galeriden yerel bilgisayara indirir ve yükler.
Sözdizimi
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 bir modülün en yeni sürümünü çevrimiçi bir galeriden 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'i 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.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | 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.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Confirm
Update-Moduleçalıştırmadan önce sizden onay ister.
| Tür: | SwitchParameter |
| Diğer adlar: | cf |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Credential
Modülü güncelleştirme izni olan bir kullanıcı hesabını belirtir.
| Tür: | PSCredential |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | 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.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-MaximumVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleUpdate-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | 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.
| Tür: | String[] |
| Position: | 0 |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | True |
-PassThru
Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Proxy
proxy cmdlet'i tarafından Update-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
| Tür: | Uri |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ProxyCredential
proxy cmdlet'i tarafından Update-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
| Tür: | PSCredential |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-RequiredVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleUpdate-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | 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
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'tır.
| Tür: | String |
| Kabul edilen değerler: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | CurrentUser |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-WhatIf
Update-Module çalıştırıldığında ne olacağını gösterir. Cmdlet çalıştırılmıyor.
| Tür: | SwitchParameter |
| Diğer adlar: | wi |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
Girişler
String[]
Çıkışlar
Notlar
PowerShell, Update-Moduleiçin aş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ştirmelerinin yükseltilmiş izinlere sahip olması gerekir.
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.
Kullanımda olan ikili dosyaları güncelleştirmeye çalışırsanız Update-Module , Update-Module sorun işlemlerini tanımlayan bir hata döndürür. İşlemler durdurulduktan sonra kullanıcıya yeniden denemesi Update-Module bildirilir.
