Save-Module

Başvuru

Modül:: PowerShellGet

Bir modülü ve onun bağımlılıklarını yerel bilgisayara kaydeder, ancak modülü yüklemez.

Syntax

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet'i Save-Module kayıtlı bir depodan bir modülü ve tüm bağımlılıkları indirir. Save-Module modülün en güncel sürümünü indirip kaydeder. Dosyalar yerel bilgisayarda belirtilen yola kaydedilir. Modül yüklü değildir, ancak içerik bir yönetici tarafından denetlenemez. Kaydedilen modül daha sonra çevrimdışı makinenin uygun $env:PSModulePath konumuna kopyalanabilir.

Get-PSRepository yerel bilgisayarın kayıtlı depolarını görüntüler. Kayıtlı depolarda Find-Module arama yapmak için cmdlet'ini kullanabilirsiniz.

Modül sürüm numaralarını alan parametreler, sürüm numaraları olarak biçimlendirilmiş dizeler bekler.

Standart sürüm numaraları, x, y ve z'nin x.y.z sayı olduğu bir biçime sahiptir
Yayın öncesi sürümler, sürümüne x.y.z-<prerelease_label><prerelease_label> rastgele dizenin atandığı bir biçime sahiptir.

Örnekler

Örnek 1: Modülü kaydetme

Bu örnekte, bir modül ve bağımlılıkları yerel bilgisayara kaydedilir.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

Save-Module, PowerShellGet modülünü belirtmek için Name parametresini kullanır. Path parametresi, indirilen modülün depolandığı yeri belirtir. Repository parametresi, PSGallery adlı kayıtlı bir depoyu belirtir. İndirme işlemi tamamlandıktan sonra dosyaların Get-ChildItem depolandığı Yolun içeriğini görüntüler.

Örnek 2: Modülün belirli bir sürümünü kaydetme

Bu örnekte, modül sürümünü belirtmek için MaximumVersion veya RequiredVersion gibi bir parametrenin nasıl kullanılacağı gösterilmektedir.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

Save-Module, PowerShellGet modülünü belirtmek için Name parametresini kullanır. Path parametresi, indirilen modülün depolandığı yeri belirtir. Repository parametresi, PSGallery adlı kayıtlı bir depoyu belirtir. MaximumVersion, 2.1.0 sürümünün indirilip kaydedildiğini belirtir. İndirme işlemi tamamlandıktan sonra dosyaların Get-ChildItem depolandığı Yolun içeriğini görüntüler.

Örnek 3: Modülün belirli bir sürümünü bulma ve kaydetme

Bu örnekte, depoda gerekli bir modül sürümü bulunur ve yerel bilgisayara kaydedilir.

Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

Find-Module, PowerShellGet modülünü belirtmek için Name parametresini kullanır. Repository parametresi, PSGallery adlı kayıtlı bir depoyu belirtir. RequiredVersion1.6.5 sürümünü belirtir.

nesnesi işlem hattına Save-Modulegönderilir. Path parametresi, indirilen modülün depolandığı yeri belirtir. İndirme işlemi tamamlandıktan sonra dosyaların Get-ChildItem depolandığı Yolun içeriğini görüntüler.

Parametreler

-AcceptLicense

Paket gerektiriyorsa lisans sözleşmesini otomatik olarak kabul edin.

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

-AllowPrerelease

Ön sürüm olarak işaretlenmiş bir modülü kaydetmenizi sağlar.

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

-Confirm

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

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

-Credential

Modülü kaydetme hakları olan bir kullanıcı hesabını belirtir.

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

-Force

Path parametresi tarafından belirtilen konum yoksa, cmdlet bir hata döndürür. Force parametresini kullanmak hedef yolu oluşturur.

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

-InputObject

PSRepositoryItemInfo nesnesini kabul eder. Örneğin, bir değişkene çıkış yapın Find-Module ve bu değişkeni InputObject bağımsız değişkeni olarak kullanın.

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

-LiteralPath

Bir veya daha fazla konumun yolunu belirtir. LiteralPath parametresinin değeri tam olarak girilmiş olarak kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, bunları tek tırnak içine alın. PowerShell, tek tırnak içine alınmış karakterleri kaçış dizisi olarak yorumlamaz.

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

-MaximumVersion

Kaydedilecek modülün en büyük veya en yeni sürümünü belirtir. MaximumVersion ve RequiredVersion parametreleri aynı komutta kullanılamaz.

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

-MinimumVersion

Kaydedilecek tek bir modülün en düşük sürümünü belirtir. Birden çok modül yüklemeye çalıştığınızda bu parametreyi ekleyemezsiniz. MinimumVersion ve RequiredVersion parametreleri aynı komutta kullanılamaz.

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

-Name

Kaydedilecek modüllerin ad dizisini belirtir.

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

-Path

Kaydedilen modülün depolmak için yerel bilgisayardaki konumu belirtir. Joker karakterleri kabul eder.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	True

-Proxy

doğrudan İnternet kaynağına bağlanmak yerine istek için bir proxy sunucusu belirtir.

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

-ProxyCredential

Proxy parametresi tarafından belirtilen ara sunucuyu kullanma iznine sahip bir kullanıcı hesabı belirtir.

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

-Repository

çalıştırılarak Register-PSRepositorykaydedilmiş bir deponun kolay adını belirtir. Kayıtlı depoları görüntülemek için kullanın Get-PSRepository .

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

-RequiredVersion

Kaydedilecek modülün tam sürüm numarasını belirtir.

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

-WhatIf

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

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

Girişler

String[]

PSObject[]

String

Uri

PSCredential

Çıkışlar

Object

Notlar

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