Save-Module
Bir modülü ve onun bağımlılıklarını yerel bilgisayara kaydeder, ancak modülü yüklemez.
Sözdizimi
NameAndPathParameterSet EnterprisePublishing
Save-Module
[-Name] <String[]>
[-Path] <String>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameAndLiteralPathParameterSet
Save-Module
[-Name] <String[]>
-LiteralPath <String>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <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ü indirir ve kaydeder. Dosyalar yerel bilgisayarda belirtilen bir 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.
Bu, Save-PSResource içindeki cmdlet için bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Save-PSResource
Ö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ığı Yol 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 indirildiğini ve kaydedildiğini belirtir. İndirme işlemi tamamlandıktan sonra dosyaların Get-ChildItem depolandığı Yol 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.
RequiredVersion 1.6.5 sürümünü belirtir.
Nesne Save-Moduleişlem hattına gönderilir.
Path parametresi, indirilen modülün depolandığı yeri belirtir. İndirme işlemi tamamlandıktan sonra dosyaların Get-ChildItem depolandığı Yol içeriğini görüntüler.
Parametreler
-AcceptLicense
proxy cmdlet'i tarafından Save-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
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
Ön sürüm olarak işaretlenmiş bir modülü kaydetmenizi sağlar.
Proxy cmdlet'i bu parametreyi ön sürüm parametresiyle eşler Save-PSResource.
Parametre özellikleri
Tür: SwitchParameter
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
NameAndPathParameterSet
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
NameAndLiteralPathParameterSet
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
Save-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ü kaydetme hakları 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
proxy cmdlet'i tarafından Save-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
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
PSRepositoryItemInfo nesnesini kabul eder. Örneğin, çıktı bir değişkene Find-Module ve bu değişkeni InputObject bağımsız değişkeni olarak kullanır.
Tür: PSObject [ ]
Default value: None
Joker karakterleri destekler: False
DontShow: False
InputObjectAndLiteralPathParameterSet
Position: 0
Zorunlu: True
İşlem hattından gelen değer: True
Ö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
InputObjectAndPathParameterSet
Position: 0
Zorunlu: True
İşlem hattından gelen değer: True
Ö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
-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.
Proxy cmdlet'i bu parametreyi path parametresiyle Save-PSResourceeşler.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Diğer adlar: PSPath
Parametre kümeleri
NameAndLiteralPathParameterSet
Position: Named
Zorunlu: True
İş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
InputObjectAndLiteralPathParameterSet
Position: Named
Zorunlu: True
İş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
-MaximumVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyle Save-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
NameAndPathParameterSet
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
NameAndLiteralPathParameterSet
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
-MinimumVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyle Save-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
NameAndPathParameterSet
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
NameAndLiteralPathParameterSet
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
Kaydedilecek modüllerin ad dizisini belirtir.
Parametre özellikleri
Tür: String [ ]
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
NameAndPathParameterSet
Position: 0
Zorunlu: True
İş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
NameAndLiteralPathParameterSet
Position: 0
Zorunlu: True
İş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
-Path
Kaydedilen modülün depolmak için yerel bilgisayardaki konumu belirtir. Joker karakterleri kabul eder.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: True
DontShow: False
Parametre kümeleri
NameAndPathParameterSet
Position: 1
Zorunlu: True
İş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
InputObjectAndPathParameterSet
Position: 1
Zorunlu: True
İş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
-Proxy
proxy cmdlet'i tarafından Save-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 Save-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
-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 .
Parametre özellikleri
Tür: String [ ]
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
NameAndPathParameterSet
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
NameAndLiteralPathParameterSet
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 parametresiyle Save-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
NameAndPathParameterSet
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
NameAndLiteralPathParameterSet
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
-WhatIf
Save-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 .
Çıkışlar
Notlar
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