Megosztás a következőn keresztül:

Update-ModuleManifest

  • Referencia
Modul:
PowerShellGet

Frissítések egy modul jegyzékfájlja.

Syntax

Update-ModuleManifest
      [-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[]>]
      [-PrivateData <Hashtable>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String[]>]
      [-Prerelease <String>]
      [-HelpInfoUri <Uri>]
      [-PassThru]
      [-DefaultCommandPrefix <String>]
      [-ExternalModuleDependencies <String[]>]
      [-PackageManagementProviders <String[]>]
      [-RequireLicenseAcceptance]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

A Update-ModuleManifest parancsmag frissíti a moduljegyzékfájlt (.psd1).

Ez egy proxyparancsmag a Update-PSModuleManifestMicrosoft.PowerShell.PSResourceGet parancsmaghoz. További információ: Update-PSModuleManifest.

Példák

1. példa: Moduljegyzék frissítése

Ez a példa frissít egy meglévő moduljegyzékfájlt. A Splatting paraméterértékek átadására szolgál.Update-ModuleManifest További információ: about_Splatting.

$Params = @{
  Path = "C:\Test\TestManifest.psd1"
  Author = "TestUser1"
  CompanyName = "Contoso Corporation"
  Copyright = "(c) 2019 Contoso Corporation. All rights reserved."
}

Update-ModuleManifest @Params

$Params egy splat, amely a Path, a Author, a CompanyName és a Copyright paraméterértékeket tárolja. Update-ModuleManifest lekéri a paraméterértékeket, @Params és frissíti a TestManifest.psd1 moduljegyzéket.

Paraméterek

-AliasesToExport

Meghatározza a modul által exportált aliasokat. Helyettesítő karakterek használata engedélyezett.

Ezzel a paramétersel korlátozhatja a modul által exportált aliasokat. Az AliasesToExport eltávolíthatja az aliasokat az exportált aliasok listájából, de nem adhat hozzá aliasokat a listához.

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 Modulhoz szükséges Microsoft-.NET-keretrendszer Common Language Runtime (CLR) minimális verzióját.

Megjegyzés

Ez a beállítás csak a PowerShell Desktop kiadásra érvényes, például az 5.1-Windows PowerShell, és csak a 4.5-ösnél kisebb .NET-keretrendszer verziókra vonatkozik. Ez a követelmény nincs hatással a PowerShell újabb verzióira vagy a .NET-keretrendszer.

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.

Ezzel a paramétersel korlátozhatja a modul által exportált parancsmagokat. A CmdletsToExport eltávolíthatja a parancsmagokat az exportált parancsmagok listájából, de nem tud parancsmagokat hozzáadni a listához.

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

-CompanyName

Meghatározza 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-jait . A PSEditionről további információt a Kompatibilis PowerShell-kiadásokkal rendelkező modulok című témakörben talál.

Type:String[]
Accepted values:Desktop, Core
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Megerősítést kér a futtatás Update-ModuleManifestelőtt.

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

-Copyright

A modul szerzői jogi nyilatkozatát adja meg.

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

Megadja a Microsoft .NET-keretrendszer minimális verzióját, amelyet a modul igényel.

Megjegyzés

Ez a beállítás csak a PowerShell Desktop kiadásra érvényes, például az 5.1-Windows PowerShell, és csak a 4.5-ösnél kisebb .NET-keretrendszer verziókra vonatkozik. Ez a követelmény nincs hatással a PowerShell újabb verzióira vagy a .NET-keretrendszer.

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

-DscResourcesToExport

Meghatározza 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:False

-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

Meghatározza a modul importálásakor futtatott formázási fájlokat (.ps1xml).

Modul importálásakor a PowerShell a Update-FormatData megadott fájlokkal futtatja a parancsmagot. Mivel a formázási fájlok nincsenek hatókörben, 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.

Ezzel a paramétersel korlátozhatja a modul által exportált függvényeket. A FunctionsToExport eltávolíthat függvényeket az exportált aliasok listájából, de nem tud függvényeket hozzáadni a listához.

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

-Guid

A modul egyedi azonosítójának megadása. A GUID használható az azonos nevű modulok megkülönböztetésére.

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

-HelpInfoUri

A modul HelpInfo XML-fájljának internetes címét adja meg. Adjon meg egy egységes erőforrás-azonosítót (URI), amely http-vel vagy https-lel kezdődik.

A HelpInfo XML-fájl támogatja a PowerShell 3.0-s verziójában bevezetett Frissíthető súgó funkciót. Információkat tartalmaz a modul letölthető súgófájljainak helyéről, valamint az egyes támogatott területi beállítások legújabb súgófájljainak verziószámáról.

Az frissíthető súgóval kapcsolatos információkért lásd: about_Updatable_Help. További információ a HelpInfo XML-fájlról : Frissíthető súgó támogatása.

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

-IconUri

Megadja a modul ikonjának URL-címét. 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 modul részét képező modulok tömbjének megadása.

Adja meg az egyes modulneveket sztringként vagy kivonattáblaké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. A kulcs értékében felsorolt modulok feldolgozása nem történik meg automatikusan.

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

Meghatározza a modul munkamenet-állapotába importált szkriptmodulokat (.psm1) és bináris modulokat (.dll). A NestedModules kulcs fájljai abban a sorrendben futnak, amelyben az értékben szerepelnek.

Adja meg az egyes modulneveket sztringként vagy kivonattáblaké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

-PackageManagementProviders

A csomagkezelő szolgáltatók tömbjének megadása.

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

-PassThru

Egy objektumot ad vissza, amely azt az elemet jelöli, amellyel dolgozik. Alapértelmezés szerint Update-ModuleManifest nem hoz létre kimenetet.

Type:SwitchParameter
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. Adjon meg egy elérési utat és egy fájlnevet egy .psd1 fájlnévkiterjesztéssel, például $PSHOME\Modules\MyModule\MyModule.psd1: .

Ha egy meglévő fájl elérési útját adja meg, figyelmeztetés nélkül lecseréli a fájlt, Update-ModuleManifest kivéve, ha a fájl írásvédett attribútummal rendelkezik.

A jegyzékfájlnak a modul könyvtárában kell lennie, és a jegyzékfájl nevének meg kell egyeznie a modul könyvtárnevével, de kiterjesztéssel .psd1 .

Az elérésiút-paraméter értékére vonatkozó kérdésre adott válaszként nem használhat változókat( például $PSHOME vagy $HOME). Változó használatához adja meg a Path paramétert a parancsban.

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

-PowerShellHostName

Megadja annak a PowerShell-gazdagépprogramnak a nevét, amelyet a modul igényel. Adja meg a gazdagépprogram nevét, például a PowerShell ISE-gazdagépet vagy a ConsoleHostot. A helyettesítő karakterek nem engedélyezettek.

A gazdagépprogram nevének megkereséséhez írja be a programba a következőt $Host.Name: .

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

-PowerShellHostVersion

Meghatározza a modullal működő PowerShell-gazdagépprogram minimális verzióját. 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

Meghatározza a PowerShell azon minimális verzióját, amely a modullal fog működni. Megadhat például 3.0, 4.0 vagy 5.0 értéket ennek a paraméternek az értékeként.

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

-Prerelease

Azt jelzi, hogy a modul előzetes verzióban van.

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.

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:

  • Amd64
  • Kar
  • IA64
  • MSIL
  • Nincs (ismeretlen vagy meghatározatlan)
  • X86
Type:ProcessorArchitecture
Accepted values:None, MSIL, X86, IA64, Amd64, Arm
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProjectUri

Megadja a projekthez tartozó weblap URL-címét.

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

-ReleaseNotes

Olyan sztringtömböt ad meg, amely a szkript ezen verziójához elérhető kibocsátási megjegyzéseket vagy megjegyzéseket tartalmaz.

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

-RequiredAssemblies

Meghatározza a modul által igényelt szerelvényfájlokat (.dll). Adja meg a szerelvényfájlneveket. 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 kulcs értékében megadott modulfájl importálása előtt.

Ezzel a paraméter használatával megadhatja a modulhoz szükséges összes szerelvényt, beleértve azokat a szerelvényeket is, 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 bináris modulokként is szerepelnek a NestedModules kulcsban.

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

-RequiredModules

Meghatározza azokat a modulokat, amelyeknek globális munkamenet-állapotban kell lenniük. Ha a szükséges modulok nincsenek globális munkamenet-állapotban, a PowerShell importálja őket. Ha a szükséges modulok nem érhetők el, a Import-Module parancs meghiúsul.

Type:Object[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequireLicenseAcceptance

Megadja, hogy a modulhoz licenc-elfogadásra van szükség.

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

-RootModule

Meghatározza a modul elsődleges vagy gyökérfájlját. Adja meg egy szkript (), egy szkriptmodul (.ps1.psm1), egy moduljegyzék (.psd1), egy szerelvény (.dll), egy parancsmagdefiníciós XML-fájl () vagy egy munkafolyamat (.xaml.cdxml) fájlnevét. A modul importálásakor a gyökérmodul-fájlból exportált tagok a hívó munkamenet-állapotába lesznek importálva.

Ha egy modul rendelkezik jegyzékfájllal, és nincs megadva gyökérfájl a RootModule kulcsban, a jegyzékfájl lesz a modul elsődleges fájlja. És a modul jegyzékmodulná válik (ModuleType = Jegyzék).

Ha egy jegyzékfájllal rendelkező modul tagjait .psm1 vagy .dll fájljait szeretné exportálni, ezeknek a fájloknak a nevét meg kell adni a jegyzékfájl RootModule vagy NestedModules kulcsainak értékeiben. Ellenkező esetben a tagok nem lesznek exportálva.

A PowerShell 2.0-ban ezt a kulcsot ModuleToProcess-nak hívták.

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

-ScriptsToProcess

A modul importálásakor a hívó munkamenet-állapotában futó szkriptfájlokat (.ps1) adja meg. Ezekkel a szkriptekkel előkészítheti a környezetet, ugyanúgy, mint egy bejelentkezési szkriptet.

A modul munkamenet-állapotában futó szkriptek megadásához használja a NestedModules kulcsot.

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

-Tags

Címkék tömbje.

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

-TypesToProcess

Megadja a modul importálásakor futtatott () típusfájlokat.ps1xml.

A modul importálásakor a PowerShell a Update-TypeData megadott fájlokkal futtatja a parancsmagot. Mivel a típusfájlok nincsenek hatókörben, 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. A VariablesToExport eltávolíthatja a változókat az exportált változók listájából, de nem tud változókat hozzáadni a listához.

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

-WhatIf

Megjeleníti, hogy mi történne, ha Update-ModuleManifest futna. A parancsmag nem fut.

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

Bevitelek

String

Kimenetek

Object