Update-Module

Modül:

PowerShellGet v3 Module

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

Sözdizimi

All

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

Description

Update-Module cmdlet'i ç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 Install-Moduleile yerel bilgisayarda yüklü olan modüller için yüklenir. Update-Module yüklü modülleri $env:PSModulePath arar.

Bu, Update-PSResource içindeki cmdlet için 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

, SpeculationControlbelirli bir modülü güncelleştirmek için Name parametresini kullanır.

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

Bu örnek, Update-Module çalıştırıldığında ne olacağını 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 neler olacağını gösteren Update-Module 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

, SpeculationControlmodülünü belirtmek için Name parametresini kullanır. RequiredVersion parametresi 1.0.14sü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

, SpeculationControlmodü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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

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

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumVersion

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

Güncelleştirilecek bir veya daha fazla modülün adını belirtir. Update-Module güncelleştirilecek modülleri $env:PSModulePath arar. Belirtilen modül adı için $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.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Proxy

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

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProxyCredential

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

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredVersion

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	CurrentUser
Kabul edilen değerler:	CurrentUser, AllUsers
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

String

PSCredential

Uri

Çıkışlar

Object

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, PowerShell'in PowerShell 3.0 veya sonraki sürümlerinde, Windows 7 veya Windows 2008 R2 ve sonraki Windows sürümlerinde çalışır.

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

Update-Module yalnızca Install-Moduleçalıştırarak çevrimiçi galeriden yüklediğiniz modüllerde çalıştırabilirsiniz.

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

İlişkili Bağlantılar

• Find-Module
• Get-InstalledModule
• Install-Module
• Publish-Module
• Uninstall-Module