Update-ModuleManifest

Frissítések egy moduljegyzékfájlt.

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 modul jegyzékfájlját (.psd1).

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 Update-ModuleManifestszolgál. További információ: about_Splatting.

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

Update-ModuleManifest @Parms

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

Paraméterek

-AliasesToExport

Megadja 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 tud aliasokat hozzáadni a listához.

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

-Author

A modul szerzőjének megadása.

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

-ClrVersion

A Microsoft .NET-keretrendszer Common Language Runtime (CLR) minimális verzióját adja meg, amelyhez a modulnak szüksége van.

Type:Version
Position:Named
Default value:None
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 képes eltávolítani 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
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
Accept pipeline input:False
Accept wildcard characters:False

-CompatiblePSEditions

Megadja a modul kompatibilis PSEdition-jait . A PSEdition szolgáltatással kapcsolatos információkért lásd a kompatibilis PowerShell-kiadásokkal rendelkező modulokat.

Type:String[]
Accepted values:Desktop, Core
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

-DefaultCommandPrefix

Az alapértelmezett parancselőtagot adja meg.

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

-Description

Megadja a modul leírását.

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

-DotNetFrameworkVersion

Meghatározza a Modulhoz szükséges Microsoft .NET-keretrendszer minimális verzióját.

Type:Version
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-ExternalModuleDependencies

Külső modulfüggőségek tömbjének megadása.

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

-FileList

Megadja a modulban szereplő összes elemet.

Type:String[]
Position:Named
Default value:None
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 nem hatókörrel rendelkeznek, a munkamenet összes munkamenetállapotára hatással vannak.

Type:String[]
Position:Named
Default value:None
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
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
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 http vagy https kezdetű egységes erőforrás-azonosítót (URI).

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ámairól.

A frissíthető súgóval kapcsolatos információkért lásd: about_Updatable_Help. A HelpInfo XML-fájlról további információt a Frissíthető súgó támogatása című témakörben talál.

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

-IconUri

A modul ikonjának URL-címét adja meg. A megadott ikon megjelenik a modul katalógusának weblapján.

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

-LicenseUri

Megadja a modul licencfeltételeinek URL-címét.

Type:Uri
Position:Named
Default value:None
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á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
Accept pipeline input:False
Accept wildcard characters:False

-ModuleVersion

A modul verzióját adja meg.

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

-NestedModules

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

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
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
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
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 az Elérési út paramétert a parancsban.

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

-PowerShellHostName

A modulhoz szükséges PowerShell-gazdagépprogram nevét adja meg. Adja meg a gazdagépprogram nevét, például a PowerShell ISE-gazdagépet vagy a ConsoleHostot. Helyettesítő karakterek használata nem engedélyezett.

A gazdagépprogram nevének megkereséséhez írja be a programba $Host.Name.

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

-PowerShellHostVersion

A modullal kompatibilis PowerShell-gazdagépprogram minimális verzióját határozza meg. Adjon meg egy verziószámot( például 1.1).

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

-PowerShellVersion

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

Type:Version
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

-ProcessorArchitecture

Megadja a modulhoz szükséges 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
Accept pipeline input:False
Accept wildcard characters:False

-ProjectUri

A projekthez tartozó weblap URL-címét adja meg.

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

-ReleaseNotes

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

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

-RequiredAssemblies

A modulhoz szükséges szerelvényfájlok (.dll) megadása. 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éterzel 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
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 sikertelen lesz.

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

-RequireLicenseAcceptance

Megadja, hogy a modulhoz licenc elfogadása szükséges.

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

-RootModule

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

Ha egy modul jegyzékfájllal rendelkezik, é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ékmodul lesz (ModuleType = Manifest).

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ékei között. Ellenkező esetben a tagok nem lesznek exportálva.

A PowerShell 2.0-ban ez a kulcs a ModuleToProcess volt.

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-Tags

Címkék tömbje.

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

-TypesToProcess

Megadja a modul importálásakor futó 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 hatóköre nem terjed ki, a munkamenet összes munkamenet-állapotára hatással vannak.

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

-VariablesToExport

Megadja 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 képes eltávolítani a változókat az exportált változók listájáról, de nem tud változókat hozzáadni a listához.

Type:String[]
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

Kimenetek

Object

Jegyzetek

Fontos

2020 áprilisától a PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2-t vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-galéria elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

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

További információt a PowerShell-blog közleményében talál.