Save-Module

Menyimpan modul dan dependensinya di komputer lokal tetapi tidak menginstal modul.

Sintaks

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

Deskripsi

Save-Module Cmdlet mengunduh modul dan dependensi apa pun dari repositori terdaftar. Save-Module mengunduh dan menyimpan versi terbaru modul. File disimpan ke jalur yang ditentukan pada komputer lokal. Modul tidak diinstal, tetapi konten tersedia untuk diperiksa oleh administrator. Modul yang disimpan kemudian dapat disalin ke lokasi komputer offline yang sesuai $env:PSModulePath .

Get-PSRepository menampilkan repositori terdaftar komputer lokal. Anda dapat menggunakan Find-Module cmdlet untuk mencari repositori terdaftar.

Contoh

Contoh 1: Menyimpan modul

Dalam contoh ini, modul dan dependensinya disimpan ke komputer lokal.

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 menggunakan parameter Nama untuk menentukan modul, PowerShellGet. Parameter Jalur menentukan tempat untuk menyimpan modul yang diunduh. Parameter Repositori menentukan repositori terdaftar, PSGallery. Setelah pengunduhan selesai, Get-ChildItem menampilkan konten Jalur tempat file disimpan.

Contoh 2: Menyimpan versi modul tertentu

Contoh ini menunjukkan cara menggunakan parameter seperti MaximumVersion, atau RequiredVersion untuk menentukan versi modul.

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 menggunakan parameter Nama untuk menentukan modul, PowerShellGet. Parameter Jalur menentukan tempat untuk menyimpan modul yang diunduh. Parameter Repositori menentukan repositori terdaftar, PSGallery. MaximumVersion menentukan bahwa versi 2.1.0 diunduh dan disimpan. Setelah pengunduhan selesai, Get-ChildItem menampilkan konten Jalur tempat file disimpan.

Contoh 3: Menemukan dan menyimpan versi modul tertentu

Dalam contoh ini, versi modul yang diperlukan ditemukan di repositori dan disimpan ke komputer lokal.

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 menggunakan parameter Nama untuk menentukan modul, PowerShellGet. Parameter Repositori menentukan repositori terdaftar, PSGallery. RequiredVersion menentukan versi 1.6.5.

Objek dikirim ke alur ke Save-Module. Parameter Jalur menentukan tempat untuk menyimpan modul yang diunduh. Setelah pengunduhan selesai, Get-ChildItem menampilkan konten Jalur tempat file disimpan.

Parameter

-AcceptLicense

Terima perjanjian lisensi secara otomatis jika paket memerlukannya.

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

-AllowPrerelease

Memungkinkan Anda menyimpan modul yang ditandai sebagai prarilis.

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

-Confirm

Meminta konfirmasi sebelum menjalankan Save-Module.

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

-Credential

Menentukan akun pengguna yang memiliki hak untuk menyimpan modul.

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

-Force

Jika lokasi yang ditentukan oleh parameter Jalur tidak ada, cmdlet mengembalikan kesalahan. Menggunakan parameter Force membuat jalur target.

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

-InputObject

Menerima objek PSRepositoryItemInfo . Misalnya, output Find-Module ke variabel dan gunakan variabel tersebut sebagai argumen InputObject .

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

-LiteralPath

Menentukan jalur ke satu atau beberapa lokasi. Nilai parameter LiteralPath digunakan persis seperti yang dimasukkan. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan karakter tersebut dalam tanda kutip tunggal. PowerShell tidak menginterpretasikan karakter apa pun yang diapit dalam tanda kutip tunggal sebagai urutan escape.

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

-MaximumVersion

Menentukan versi modul maksimum, atau terbaru yang akan disimpan. Parameter MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

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

-MinimumVersion

Menentukan versi minimum modul tunggal untuk disimpan. Anda tidak dapat menambahkan parameter ini jika Anda mencoba menginstal beberapa modul. Parameter MinimumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

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

-Name

Menentukan array nama modul untuk disimpan.

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

-Path

Menentukan lokasi pada komputer lokal untuk menyimpan modul tersimpan. Menerima karakter kartubebas.

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

-Proxy

Menentukan server proksi untuk permintaan, daripada menyambungkan langsung ke sumber daya internet.

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

-ProxyCredential

Menentukan akun pengguna yang memiliki izin untuk menggunakan server proksi yang ditentukan oleh parameter Proksi .

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

-Repository

Menentukan nama repositori yang mudah diingat yang telah didaftarkan dengan menjalankan Register-PSRepository. Gunakan Get-PSRepository untuk menampilkan repositori terdaftar.

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

-RequiredVersion

Menentukan nomor versi modul yang tepat untuk disimpan.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika Save-Module eksekusi. Cmdlet tidak dijalankan.

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

Input

String[]

PSObject[]

String

Uri

PSCredential

Output

Object

Catatan

Penting

Mulai April 2020, PowerShell Gallery tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Untuk informasi selengkapnya, lihat pengumuman di blog PowerShell.