Save-Module

Modul:

PowerShellGet Module

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

Sintaks

NameAndPathParameterSet (Default)

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

Deskripsi

cmdlet Save-Module mengunduh modul dan dependensi apa pun dari repositori terdaftar. Save-Module mengunduh dan menyimpan versi modul terbaru. 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 cmdlet Find-Module untuk mencari repositori terdaftar.

Parameter yang mengambil nomor versi modul mengharapkan string yang diformat sebagai nomor versi.

• Nomor versi standar memiliki format di x.y.z mana x, y, dan z adalah angka
• Versi prarilis memiliki format x.y.z-<prerelease_label> di mana string arbitrer ditetapkan ke rilis tersebut <prerelease_label> .

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

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

menggunakan parameter Nama untuk menentukan modul, PowerShellGet. Parameter Jalur menentukan tempat 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 Path 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

menggunakan parameter Nama untuk menentukan modul, PowerShellGet. Parameter Repositori menentukan repositori terdaftar, PSGallery. RequiredVersion menentukan versi 1.6.5.

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

Parameter

-AcceptLicense

Terima perjanjian lisensi secara otomatis jika paket memerlukannya.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-AllowPrerelease

Memungkinkan Anda menyimpan modul yang ditandai sebagai prarilis.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NameAndLiteralPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan Save-Module.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Credential

Menentukan akun pengguna yang memiliki hak untuk menyimpan modul.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Force

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

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

Properti parameter

Jenis:	PSObject[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

InputObjectAndLiteralPathParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

InputObjectAndPathParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LiteralPath

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	PSPath

Kumpulan parameter

NameAndLiteralPathParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

InputObjectAndLiteralPathParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-MaximumVersion

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

NameAndLiteralPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

NameAndLiteralPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Name

Menentukan array nama modul untuk disimpan.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

NameAndLiteralPathParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Path

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	True
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

InputObjectAndPathParameterSet

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Proxy

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

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ProxyCredential

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

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Repository

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

NameAndLiteralPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-RequiredVersion

Menentukan nomor versi modul yang tepat untuk disimpan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameAndPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

NameAndLiteralPathParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-WhatIf

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

PSObject

String

Uri

PSCredential

Output

Object

Catatan

Penting

Pada April 2020, Galeri PowerShell 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.