Update-Module
Belirtilen modüllerin en yeni sürümünü çevrimiçi bir galeriden yerel bilgisayara indirir ve 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-Module
yerel bilgisayarda yüklü olan modüller için yüklenir. Update-Module
$env:PSModulePath
yüklü modülleri arar.
Update-Module
parametresi belirtilmediğinde tüm yüklü modüller güncelleştirilir. Güncelleştirilecek modülü belirtmek için Name parametresini kullanın. RequiredVersion parametresini kullanarak modülün belirli bir sürümüne güncelleştirebilirsiniz.
Yüklü bir modül zaten en yeni sürümse modül güncelleştirilmez. Modül içinde $env:PSModulePath
bulunamazsa bir hata görüntülenir.
Yüklü modülleri görüntülemek için kullanın Get-InstalledModule
.
Ö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-Module
Belirli 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.
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
Güncelleştirilecek tek bir modülün en yüksek sürümünü belirtir. Birden çok modülü güncelleştirmeye çalıştığınızda bu parametreyi ekleyemezsiniz. MaximumVersion ve RequiredVersion parametreleri aynı komutta kullanılamaz.
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
doğrudan bir internet kaynağına bağlanmak yerine istek için bir proxy sunucusu belirtir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Proxy parametresi tarafından belirtilen ara sunucuyu kullanma izni olan bir kullanıcı hesabı belirtir.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RequiredVersion
Mevcut yüklü modülün güncelleştirileceği tam sürümü belirtir. RequiredVersion tarafından belirtilen sürüm çevrimiçi galeride mevcut olmalıdır veya bir hata görüntülenir. Tek bir komutta birden fazla modül güncelleştirildiyse RequiredVersion kullanamazsınız.
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[]
Çıkışlar
Notlar
PowerShell sürüm 6.0 ve üzeri için varsayılan yükleme kapsamı her zaman CurrentUser'dır.
CurrentUser, $home\Documents\PowerShell\Modules
için modül güncelleştirmelerinin yükseltilmiş izinlere ihtiyacı yoktur. AllUsers, $env:ProgramFiles\PowerShell\Modules
için modül güncelleştirmeleri yükseltilmiş izinlere ihtiyaç duyar.
Önemli
Nisan 2020 itibarıyla 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 kullanmıyorsanız, PowerShell Galerisi erişmeye çalışırken bir hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Daha fazla bilgi için PowerShell blogundaki duyuruya bakın.
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-Module
yü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.