Aracılığıyla paylaş


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

InputObjectAndLiteralPathParameterSet

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

InputObjectAndPathParameterSet

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

-InputObject

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.

Parametre özellikleri

Tür:

PSObject[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

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

Girişler

String

PSObject

String

Uri

PSCredential

Çıkışlar

Object

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