Update-PSModuleManifest
Updates file manifes modul.
Sintaks
Update-PSModuleManifest
[-Path] <String>
[-NestedModules <Object[]>]
[-Guid <Guid>]
[-Author <String>]
[-CompanyName <String>]
[-Copyright <String>]
[-RootModule <String>]
[-ModuleVersion <Version>]
[-Description <String>]
[-ProcessorArchitecture <ProcessorArchitecture>]
[-CompatiblePSEditions <String[]>]
[-PowerShellVersion <Version>]
[-ClrVersion <Version>]
[-DotNetFrameworkVersion <Version>]
[-PowerShellHostName <String>]
[-PowerShellHostVersion <Version>]
[-RequiredModules <Object[]>]
[-TypesToProcess <String[]>]
[-FormatsToProcess <String[]>]
[-ScriptsToProcess <String[]>]
[-RequiredAssemblies <String[]>]
[-FileList <String[]>]
[-ModuleList <Object[]>]
[-FunctionsToExport <String[]>]
[-AliasesToExport <String[]>]
[-VariablesToExport <String[]>]
[-CmdletsToExport <String[]>]
[-DscResourcesToExport <String[]>]
[-Tags <String[]>]
[-ProjectUri <Uri>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ReleaseNotes <String>]
[-Prerelease <String>]
[-HelpInfoUri <Uri>]
[-DefaultCommandPrefix <String>]
[-ExternalModuleDependencies <String[]>]
[-RequireLicenseAcceptance]
[-PrivateData <Hashtable>]
[<CommonParameters>]
Deskripsi
Cmdlet ini memperbarui data yang disimpan dalam file manifes modul. Parameter memungkinkan Anda menentukan properti mana yang akan diperbarui. Update-PSModuleManifest
menimpa nilai yang ada dalam manifes modul.
Cmdlet tidak mengembalikan objek.
Contoh
Contoh 1
Contoh ini mengubah properti Penulis dalam manifes modul menjadi New Author
.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'
Contoh 2
Contoh ini mengubah properti Prarilis menjadi beta2
.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'
Contoh: 3
Contoh ini memperbarui beberapa properti.
$parameters = @{
Path = 'C:\MyModules\TestModule'
Tags = 'Windows', 'Linux'
Description = 'A module for managing packages.'
}
Update-PSModuleManifest
Parameter
-AliasesToExport
Menentukan alias yang diekspor modul. Kartubebas diizinkan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Author
Menentukan penulis modul.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClrVersion
Menentukan versi minimum Common Language Runtime (CLR) microsoft .NET Framework yang diperlukan oleh modul.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CmdletsToExport
Menentukan cmdlet yang diekspor modul. Kartubebas diizinkan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-CompanyName
Menentukan perusahaan atau vendor yang membuat modul.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompatiblePSEditions
Menentukan PSEdisi modul yang kompatibel. Untuk informasi tentang PSEdition, lihat Modul dengan Edisi PowerShell yang kompatibel.
Type: | String[] |
Accepted values: | Desktop, Core |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Copyright
Menentukan pernyataan hak cipta untuk modul.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultCommandPrefix
Menentukan awalan perintah default.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Menentukan deskripsi modul.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DotNetFrameworkVersion
Menentukan versi minimum Microsoft .NET Framework yang diperlukan oleh modul.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DscResourcesToExport
Menentukan sumber daya Desired State Configuration (DSC) yang diekspor modul. Kartubebas diizinkan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ExternalModuleDependencies
Menentukan array dependensi modul eksternal.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileList
Menentukan semua item yang disertakan dalam modul.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatsToProcess
Menentukan file pemformatan (.ps1xml
) yang diproses saat modul diimpor.
Saat Anda mengimpor modul, PowerShell menjalankan Update-FormatData
cmdlet dengan file yang ditentukan.
Karena file pemformatan tidak terlingkup, file tersebut memengaruhi semua status sesi dalam sesi.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FunctionsToExport
Menentukan fungsi yang diekspor modul. Kartubebas diizinkan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Guid
Menentukan pengidentifikasi unik untuk modul. GUID digunakan untuk membedakan antara modul dengan nama yang sama.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HelpInfoUri
Menentukan alamat internet file XML HelpInfo modul. Masukkan Pengidentifikasi Sumber Daya Seragam (URI) yang dimulai dengan http:
atau https:
.
Untuk informasi selengkapnya, lihat Bantuan yang Dapat Diperbarui.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Menentukan URI ikon untuk modul. Ikon yang ditentukan ditampilkan di halaman web galeri untuk modul.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseUri
Menentukan URL istilah lisensi untuk modul.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleList
Menentukan array modul yang disertakan dalam modul.
Masukkan setiap nama modul sebagai string atau sebagai hashtable dengan kunci ModuleName dan ModuleVersion . Hashtable juga dapat memiliki kunci GUID opsional. Anda dapat menggabungkan string dan hashtable dalam nilai parameter.
Kunci ini dirancang untuk bertindak sebagai inventori modul.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleVersion
Menentukan versi modul.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NestedModules
Menentukan modul skrip (.psm1
) dan modul biner (.dll
) yang diimpor ke status sesi modul. File dalam kunci NestedModules berjalan dalam urutan di mana file tersebut tercantum.
Masukkan setiap nama modul sebagai string atau sebagai hashtable dengan kunci ModuleName dan ModuleVersion . Hashtable juga dapat memiliki kunci GUID opsional. Anda dapat menggabungkan string dan hashtable dalam nilai parameter.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Menentukan jalur dan nama file manifes modul. Masukkan nama file dengan .psd1
ekstensi file.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostName
Menentukan nama program host PowerShell yang diperlukan modul. Masukkan nama program host, seperti PowerShell ISE Host atau ConsoleHost. Kartubebas tidak diizinkan.
Nama program host disimpan di $Host.Name
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostVersion
Menentukan versi minimum program host PowerShell yang berfungsi dengan modul. Masukkan nomor versi, seperti 1.1.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellVersion
Menentukan versi minimum PowerShell yang berfungsi dengan modul ini. Misalnya, Anda dapat menentukan versi seperti 5.1
atau 7.2
.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Menentukan nilai prarilis yang ditambahkan ke versi modul. Misalnya, jika Prarilis adalah preview
dan ModuleVersion adalah 1.0.0
, versi modulnya adalah 1.0.0-preview
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateData
Menentukan data yang diteruskan ke modul saat diimpor. Ini bisa menjadi nilai arbitrer apa pun yang disimpan dalam hashtable.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProcessorArchitecture
Menentukan arsitektur prosesor yang diperlukan modul.
Nilai yang dapat diterima untuk parameter ini adalah:
Amd64
Arm
IA64
MSIL
None
(tidak diketahui atau tidak ditentukan)X86
Type: | ProcessorArchitecture |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProjectUri
Menentukan URI halaman web tentang proyek ini.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseNotes
Menentukan string yang berisi catatan rilis atau komentar untuk modul.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredAssemblies
Menentukan file assembly (.dll
) yang diperlukan oleh modul. PowerShell memuat rakitan yang ditentukan sebelum memperbarui jenis atau format, mengimpor modul berlapis, atau mengimpor file modul yang ditentukan dalam kunci RootModule .
Gunakan RequiredAssemblies untuk rakitan yang harus dimuat untuk memperbarui pemformatan atau mengetik file apa pun yang tercantum dalam kunci FormatsToProcess atau TypeToProcess , bahkan jika rakitan tersebut juga tercantum dalam kunci NestedModules .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredModules
Menentukan modul yang harus dalam status sesi global. Jika modul yang diperlukan tidak dalam status sesi global, PowerShell mengimpornya. Jika modul yang diperlukan tidak tersedia, Import-Module
perintah gagal.
Nilainya dapat berupa array yang berisi nama modul atau spesifikasi modul. Spesifikasi modul adalah hashtable yang memiliki kunci berikut.
ModuleName
- Diperlukan Menentukan nama modul.GUID
- Opsional Menentukan GUID modul.- Diperlukan juga untuk menentukan setidaknya salah satu dari tiga kunci di bawah ini.
ModuleVersion
- Menentukan versi minimum modul yang dapat diterima.MaximumVersion
- Menentukan versi maksimum modul yang dapat diterima.RequiredVersion
- Menentukan versi modul yang tepat dan diperlukan. Ini tidak dapat digunakan dengan kunci Versi lainnya.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireLicenseAcceptance
Menentukan bahwa penerimaan lisensi diperlukan untuk modul.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RootModule
Menentukan file utama atau akar modul. Masukkan nama file skrip (.ps1
), modul skrip (.psm1
), manifes modul (.psd1
), rakitan (.dll
), atau file XML definisi cmdlet (.cdxml
). Saat modul diimpor, anggota yang diekspor dari modul akar diimpor ke status sesi pemanggil.
Jika modul memiliki file manifes dan tidak ada file yang ditentukan dalam kunci RootModule , manifes menjadi file utama untuk modul. Modul ini dikenal sebagai modul manifes (ModuleType =
Manifest
).
Untuk mengekspor anggota dari .psm1
atau .dll
file, nama file tersebut harus ditentukan dalam nilai kunci RootModule atau NestedModules dalam manifes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptsToProcess
Menentukan file skrip (.ps1
) yang berjalan dalam status sesi pemanggil saat modul diimpor.
Anda dapat menggunakan skrip ini untuk menyiapkan lingkungan, sama seperti Anda dapat menggunakan skrip login.
Untuk menentukan skrip yang berjalan dalam status sesi modul, gunakan kunci NestedModules .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tags
Menentukan array tag.
Type: | String[] |
Aliases: | Tag |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypesToProcess
Menentukan file jenis (.ps1xml
) yang berjalan saat modul diimpor.
Saat Anda mengimpor modul, PowerShell menjalankan Update-TypeData
cmdlet dengan file yang ditentukan.
Karena file jenis tidak terlingkup, file tersebut memengaruhi semua status sesi dalam sesi.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariablesToExport
Menentukan variabel yang diekspor modul. Kartubebas diizinkan.
Gunakan parameter ini untuk membatasi variabel mana yang diekspor oleh modul.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Input
None
Output
Catatan
Untuk deskripsi lengkap file manifes modul, lihat about_Module_Manifests.
Link Terkait
PSResourceGet
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk