Update-PSModuleManifest
moduljegyzékfájl Frissítések.
Syntax
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>] Description
Ez a parancsmag frissíti a modul jegyzékfájljában tárolt adatokat. A paraméterekkel megadhatja, hogy mely tulajdonságok frissüljenek. Update-PSModuleManifest felülírja a moduljegyzékben lévő összes meglévő értéket.
A parancsmag nem ad vissza objektumot.
Példák
1\. példa
Ez a példa a moduljegyzék Author tulajdonságát értékre módosítja New Author.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'2\. példa
Ez a példa a Prerelease tulajdonságot értékre módosítja beta2.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'3\. példa
Ez a példa több tulajdonságot is frissít.
$parameters = @{
Path = 'C:\MyModules\TestModule'
Tags = 'Windows', 'Linux'
Description = 'A module for managing packages.'
}
Update-PSModuleManifestParaméterek
-AliasesToExport
Megadja a modul által exportált aliasokat. Helyettesítő karakterek használata engedélyezett.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Author
A modul szerzőjének megadása.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClrVersion
Meghatározza a Modul által igényelt Microsoft-.NET-keretrendszer Common Language Runtime (CLR) minimális verzióját.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CmdletsToExport
Megadja a modul által exportált parancsmagokat. Helyettesítő karakterek használata engedélyezett.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-CompanyName
Megadja a modult létrehozó vállalatot vagy szállítót.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CompatiblePSEditions
Megadja a modul kompatibilis PSEdition-eit . További információ a PSEditionről: Modulok kompatibilis PowerShell-kiadásokkal.
| Type: | String[] |
| Accepted values: | Desktop, Core |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Copyright
Megadja a modul szerzői jogi nyilatkozatát.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultCommandPrefix
Az alapértelmezett parancselőtagot adja meg.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Megadja a modul leírását.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DotNetFrameworkVersion
Meghatározza a Modul által igényelt Microsoft-.NET-keretrendszer minimális verzióját.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DscResourcesToExport
Megadja a modul által exportált Desired State Configuration (DSC) erőforrásokat. Helyettesítő karakterek használata engedélyezett.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-ExternalModuleDependencies
Külső modulfüggőségek tömbje.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileList
Megadja a modulban szereplő összes elemet.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormatsToProcess
Megadja a modul importálásakor feldolgozott formázási fájlokat (.ps1xml).
Modul importálásakor a PowerShell futtatja a Update-FormatData parancsmagot a megadott fájlokkal.
Mivel a formázási fájlok nem hatókörrel rendelkeznek, a munkamenet összes munkamenet-állapotára hatással vannak.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FunctionsToExport
Meghatározza a modul által exportált függvényeket. Helyettesítő karakterek használata engedélyezett.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Guid
A modul egyedi azonosítóját adja meg. A GUID az azonos nevű modulok megkülönböztetésére szolgál.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HelpInfoUri
Megadja a modul HelpInfo XML-fájljának internetes címét. Adjon meg egy egységes erőforrás-azonosítót (URI), amely a vagy https:a kezdetűhttp:.
További információ: Frissíthető súgó.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IconUri
A modul ikonjának URI-ját adja meg. A megadott ikon megjelenik a modul katalógusának webhelyén.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LicenseUri
Megadja a modul licencelési feltételeinek URL-címét.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleList
A modulban található modulok tömbjének megadása.
Adja meg az egyes modulneveket sztringként vagy kivonattábláként a ModuleName és a ModuleVersion kulcsokkal. A kivonattábla opcionális GUID-kulccsal is rendelkezhet. A paraméterértékben sztringeket és kivonattáblákat kombinálhat.
Ez a kulcs modulleltárként szolgál.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleVersion
A modul verzióját adja meg.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NestedModules
Megadja a modul munkamenetállapotába importált szkriptmodulokat (.psm1) és bináris modulokat (.dll). A NestedModules kulcsban lévő fájlok a lista sorrendjében futnak.
Adja meg az egyes modulneveket sztringként vagy kivonattábláként a ModuleName és a ModuleVersion kulcsokkal. A kivonattábla opcionális GUID-kulccsal is rendelkezhet. A paraméterértékben sztringeket és kivonattáblákat kombinálhat.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Megadja a moduljegyzék elérési útját és fájlnevét. Adja meg a fájlnevet fájlkiterjesztéssel .psd1 .
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PowerShellHostName
Megadja annak a PowerShell-gazdagépprogramnak a nevét, amelyet a modul igényel. Adja meg a gazdaprogram nevét, például PowerShell ISE-gazdagép vagy ConsoleHost. Helyettesítő karakterek használata nem engedélyezett.
A gazdagépprogram neve a következő helyen $Host.Nametalálható: .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PowerShellHostVersion
A Modullal kompatibilis PowerShell-gazdagépprogram minimális verzióját adja meg. Adjon meg egy verziószámot( például 1.1).
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PowerShellVersion
A PowerShell ezen modullal használható minimális verzióját határozza meg. Megadhat például olyan verziókat, mint a 5.1 vagy 7.2a.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Prerelease
A modulverzióhoz hozzáfűzött előzetes értéket adja meg. Ha például a Prerelease és preview a ModuleVersion1.0.0, a modul verziója .1.0.0-preview
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrivateData
Megadja a modulnak az importáláskor átadott adatokat. Ez a kivonattáblában tárolt tetszőleges értékek lehetnek.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProcessorArchitecture
Meghatározza a modul által igényelt processzorarchitektúrát.
A paraméter elfogadható értékei a következők:
Amd64ArmIA64MSILNone(ismeretlen vagy meghatározatlan)X86
| Type: | ProcessorArchitecture |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProjectUri
Megadja a projekthez tartozó weblap URI-ját.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReleaseNotes
A modul kibocsátási megjegyzéseit vagy megjegyzéseit tartalmazó sztringet ad meg.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredAssemblies
Megadja a modul által igényelt szerelvényfájlokat (.dll). A PowerShell betölti a megadott szerelvényeket a típusok vagy formátumok frissítése, a beágyazott modulok importálása vagy a RootModule kulcsban megadott modulfájl importálása előtt.
Használja a RequiredAssemblies parancsot olyan szerelvényekhez, amelyeket be kell tölteni a FormatsToProcess vagy TypesToProcess kulcsokban felsorolt formázási vagy típusfájlok frissítéséhez, még akkor is, ha ezek a szerelvények a NestedModules kulcsban is szerepelnek.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredModules
Megadja azokat a modulokat, amelyeknek globális munkamenet-állapotban kell lenniük. Ha a szükséges modulok nem globális munkamenet-állapotban vannak, a PowerShell importálja őket. Ha a szükséges modulok nem érhetők el, a Import-Module parancs sikertelen lesz.
Az érték lehet modulneveket vagy modulspecifikációkat tartalmazó tömb. A modulspecifikáció olyan kivonattábla, amely az alábbi kulcsokkal rendelkezik.
ModuleName- Szükséges Megadja a modul nevét.GUID- Választható A modul GUID azonosítóját adja meg.- Az alábbi három kulcs közül legalább egyet meg kell adnia.
ModuleVersion– A modul minimálisan elfogadható verzióját adja meg.MaximumVersion– A modul maximálisan elfogadható verzióját adja meg.RequiredVersion– A modul pontos, kötelező verzióját adja meg. Ez nem használható a többi verziókulcshoz.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireLicenseAcceptance
Megadja, hogy a modulhoz licencelfogadás szükséges.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RootModule
Megadja a modul elsődleges vagy gyökérfájlját. Adja meg egy szkript (.ps1), egy szkriptmodul (.psm1), egy moduljegyzék (.psd1), egy szerelvény (.dll) vagy egy parancsmagdefiníciós XML-fájl () fájlnevét..cdxml A modul importálásakor a gyökérmodulból exportált tagok a hívó munkamenet-állapotába lesznek importálva.
Ha egy modul jegyzékfájllal rendelkezik, és nincs megadva fájl a RootModule kulcsban, a jegyzékfájl lesz a modul elsődleges fájlja. A modul neve jegyzékmodul (ModuleType =
Manifest).
Tagok exportálásához vagy .dll fájlokból .psm1 való exportálásához ezeknek a fájloknak a nevét meg kell adni a jegyzékfájl RootModule vagy NestedModules kulcsainak értékeiben.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptsToProcess
Olyan szkriptfájlokat (.ps1) határoz meg, amelyek a modul importálásakor a hívó munkamenet-állapotában futnak.
Ezekkel a szkriptekkel ugyanúgy készíthet elő környezetet, mint egy bejelentkezési szkriptet.
A modul munkamenet-állapotában futó szkriptek megadásához használja a BeágyazottModules kulcsot.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tags
A címkék tömbjének megadása.
| Type: | String[] |
| Aliases: | Tag |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TypesToProcess
Megadja azokat a típusfájlokat (.ps1xml), amelyek a modul importálásakor futnak.
A modul importálásakor a PowerShell futtatja a Update-TypeData parancsmagot a megadott fájlokkal.
Mivel a típusfájlok hatóköre nem terjed ki, a munkamenet összes munkamenet-állapotára hatással vannak.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VariablesToExport
Meghatározza a modul által exportált változókat. Helyettesítő karakterek használata engedélyezett.
Ezzel a paramétersel korlátozhatja a modul által exportált változókat.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
Bevitelek
None
Kimenetek
Jegyzetek
A modul jegyzékfájljának teljes leírását lásd: about_Module_Manifests.
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: