New-ModuleManifest
Létrehoz egy új moduljegyzéket.
Syntax
New-ModuleManifest
[-Path] <String>
[-NestedModules <Object[]>]
[-Guid <Guid>]
[-Author <String>]
[-CompanyName <String>]
[-Copyright <String>]
[-RootModule <String>]
[-ModuleVersion <Version>]
[-Description <String>]
[-ProcessorArchitecture <ProcessorArchitecture>]
[-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[]>]
[-CompatiblePSEditions <String[]>]
[-PrivateData <Object>]
[-Tags <String[]>]
[-ProjectUri <Uri>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ReleaseNotes <String>]
[-Prerelease <String>]
[-RequireLicenseAcceptance]
[-ExternalModuleDependencies <String[]>]
[-HelpInfoUri <String>]
[-PassThru]
[-DefaultCommandPrefix <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
A New-ModuleManifest parancsmag létrehoz egy új moduljegyzékfájlt (.psd1), feltölti az értékeit, és menti a jegyzékfájlt a megadott elérési úton.
A modulkészítők ezzel a parancsmaggal hozhatnak létre jegyzékfájlt a moduljukhoz. A moduljegyzék egy .psd1 kivonattáblát tartalmazó fájl. A kivonattáblában szereplő kulcsok és értékek leírják a modul tartalmát és attribútumait, meghatározzák az előfeltételeket, és meghatározzák az összetevők feldolgozásának módját. A modulhoz nincs szükség jegyzékekre.
New-ModuleManifest létrehoz egy jegyzékfájlt, amely tartalmazza az összes gyakran használt jegyzékkulcsot, így az alapértelmezett kimenetet jegyzéksablonként használhatja. Ha értékeket szeretne hozzáadni vagy módosítani, vagy olyan modulkulcsokat szeretne hozzáadni, amelyeket ez a parancsmag nem ad hozzá, nyissa meg az eredményként kapott fájlt egy szövegszerkesztőben.
A Path és a PassThru kivételével minden paraméter létrehoz egy moduljegyzékkulcsot és annak értékét.
Egy moduljegyzékben csak a ModuleVersion kulcs szükséges. Ha nincs megadva a paraméter leírása, ha kihagy egy paramétert a parancsból, New-ModuleManifest létrehoz egy megjegyzéssztringet a társított értékhez, amelynek nincs hatása.
A PowerShell 2.0-ban New-ModuleManifest a parancsban nem megadott gyakran használt paraméterek értékeit kéri a szükséges paraméterértékek mellett. A PowerShell 3.0-tól kezdődően csak akkor kéri a rendszer, New-ModuleManifest ha a szükséges paraméterértékek nincsenek megadva.
Ha a modult a PowerShell-galéria szeretné közzétenni, a jegyzéknek bizonyos tulajdonságok értékeit kell tartalmaznia. További információ: A katalógus dokumentációjában a PowerShell-galéria közzétett elemek kötelező metaadatai.
Példák
1. példa – Új moduljegyzék létrehozása
Ez a példa létrehoz egy új moduljegyzéket a fájlban, amelyet az Elérési út paraméter határoz meg. A PassThru paraméter elküldi a kimenetet a folyamatnak és a fájlnak.
A kimenet a jegyzékben szereplő összes kulcs alapértelmezett értékeit jeleníti meg.
New-ModuleManifest -Path C:\ps-test\Test-Module\Test-Module.psd1 -PassThru
#
# Module manifest for module 'Test-Module'
#
# Generated by: ContosoAdmin
#
# Generated on: 7/12/2019
#
@{
# Script module or binary module file associated with this manifest.
# RootModule = ''
# Version number of this module.
ModuleVersion = '0.0.1'
# Supported PSEditions
# CompatiblePSEditions = @()
# ID used to uniquely identify this module
GUID = 'e1826c6e-c420-4eef-9ac8-185e3669ca6a'
# Author of this module
Author = 'ContosoAdmin'
# Company or vendor of this module
CompanyName = 'Unknown'
# Copyright statement for this module
Copyright = '(c) ContosoAdmin. All rights reserved.'
# Description of the functionality provided by this module
# Description = ''
# Minimum version of the PowerShell engine required by this module
# PowerShellVersion = ''
# Name of the PowerShell host required by this module
# PowerShellHostName = ''
# Minimum version of the PowerShell host required by this module
# PowerShellHostVersion = ''
# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
# DotNetFrameworkVersion = ''
# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
# CLRVersion = ''
# Processor architecture (None, X86, Amd64) required by this module
# ProcessorArchitecture = ''
# Modules that must be imported into the global environment prior to importing this module
# RequiredModules = @()
# Assemblies that must be loaded prior to importing this module
# RequiredAssemblies = @()
# Script files (.ps1) that are run in the caller's environment prior to importing this module.
# ScriptsToProcess = @()
# Type files (.ps1xml) to be loaded when importing this module
# TypesToProcess = @()
# Format files (.ps1xml) to be loaded when importing this module
# FormatsToProcess = @()
# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
# NestedModules = @()
# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
FunctionsToExport = @()
# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
CmdletsToExport = @()
# Variables to export from this module
VariablesToExport = '*'
# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
AliasesToExport = @()
# DSC resources to export from this module
# DscResourcesToExport = @()
# List of all modules packaged with this module
# ModuleList = @()
# List of all files packaged with this module
# FileList = @()
# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
PrivateData = @{
PSData = @{
# Tags applied to this module. These help with module discovery in online galleries.
# Tags = @()
# A URL to the license for this module.
# LicenseUri = ''
# A URL to the main website for this project.
# ProjectUri = ''
# A URL to an icon representing this module.
# IconUri = ''
# ReleaseNotes of this module
# ReleaseNotes = ''
# Prerelease string of this module
# Prerelease = ''
# Flag to indicate whether the module requires explicit user acceptance for install/update/save
# RequireLicenseAcceptance = $false
# External dependent modules of this module
# ExternalModuleDependencies = @()
} # End of PSData hashtable
} # End of PrivateData hashtable
# HelpInfo URI of this module
# HelpInfoURI = ''
# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
# DefaultCommandPrefix = ''
}2. példa – Új jegyzék létrehozása néhány előre feltöltött beállítással
Ez a példa létrehoz egy új moduljegyzéket. A PowerShellVersion és az AliasesToExport paraméterekkel adja hozzá az értékeket a megfelelő jegyzékkulcsokhoz.
$moduleSettings = @{
PowerShellVersion = 1.0
Path = 'C:\ps-test\ManifestTest.psd1'
AliasesToExport = @(
'JKBC'
'DRC'
'TAC'
)
}
New-ModuleManifest @moduleSettings3. példa – Más modulokat igénylő jegyzék létrehozása
Ez a példa sztringformátumot használ a BitsTransfer modul nevének és a kivonattábla formátumának megadásához a PSScheduledJob modul nevének, GUID-jának és verziójának megadásához.
$moduleSettings = @{
RequiredModules = ("BitsTransfer", @{
ModuleName="PSScheduledJob"
ModuleVersion="1.0.0.0";
GUID="50cdb55f-5ab7-489f-9e94-4ec21ff51e59"
})
Path = 'C:\ps-test\ManifestTest.psd1'
}
New-ModuleManifest @moduleSettingsEz a példa bemutatja, hogyan használható a ModuleList, a RequiredModules és a NestedModules paraméter sztring- és kivonattáblázat-formátuma. Sztringeket és kivonattáblákat kombinálhat ugyanabban a paraméterértékben.
4. példa – Frissíthető súgót támogató jegyzék létrehozása
Ez a példa a HelpInfoUri paraméterrel hoz létre egy HelpInfoUri-kulcsot a moduljegyzékben. A paraméter és a kulcs értékének http-vel vagy https-lel kell kezdődnie. Ez az érték azt jelzi a frissíthető súgórendszernek, hogy hol található a modulHoz tartozó HelpInfo XML frissíthető súgóinformációs fájl.
$moduleSettings = @{
HelpInfoUri = 'http://https://go.microsoft.com/fwlink/?LinkID=603'
Path = 'C:\ps-test\ManifestTest.psd1'
}
New-ModuleManifest @moduleSettingsAz 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 az Frissíthető súgó támogatása című témakörben talál.
5. példa – Moduladatok lekérése
Ez a példa bemutatja, hogyan szerezheti be egy modul konfigurációs értékeit. A moduljegyzékben szereplő értékek a modulobjektum tulajdonságainak értékeiben jelennek meg.
A Get-Module parancsmag a Microsoft.PowerShell.Diagnostics modul listázási paraméterrel való lekérésére szolgál. A parancs elküldi a modult a parancsmagnak a Format-List modulobjektum összes tulajdonságának és értékének megjelenítéséhez.
Get-Module Microsoft.PowerShell.Diagnostics -List | Format-List -Property *
LogPipelineExecutionDetails : False
Name : Microsoft.PowerShell.Diagnostics
Path : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Microsoft.PowerShell.Diagnostics\Micro
soft.PowerShell.Diagnostics.psd1
Definition :
Description :
Guid : ca046f10-ca64-4740-8ff9-2565dba61a4f
HelpInfoUri : https://go.microsoft.com/fwlink/?LinkID=210596
ModuleBase : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Microsoft.PowerShell.Diagnostics
PrivateData :
Version : 3.0.0.0
ModuleType : Manifest
Author : Microsoft Corporation
AccessMode : ReadWrite
ClrVersion : 4.0
CompanyName : Microsoft Corporation
Copyright : Microsoft Corporation. All rights reserved.
DotNetFrameworkVersion :
ExportedFunctions : {}
ExportedCmdlets : {[Get-WinEvent, Get-WinEvent], [Get-Counter, Get-Counter], [Import-Counter,
Import-Counter], [Export-Counter, Export-Counter]...}
ExportedCommands : {[Get-WinEvent, Get-WinEvent], [Get-Counter, Get-Counter], [Import-Counter,
Import-Counter], [Export-Counter, Export-Counter]...}
FileList : {}
ModuleList : {}
NestedModules : {}
PowerShellHostName :
PowerShellHostVersion :
PowerShellVersion : 3.0
ProcessorArchitecture : None
Scripts : {}
RequiredAssemblies : {}
RequiredModules : {}
RootModule :
ExportedVariables : {}
ExportedAliases : {}
ExportedWorkflows : {}
SessionState :
OnRemove :
ExportedFormatFiles : {C:\Windows\system32\WindowsPowerShell\v1.0\Event.format.ps1xml,
C:\Windows\system32\WindowsPowerShell\v1.0\Diagnostics.format.ps1xml}
ExportedTypeFiles : {C:\Windows\system32\WindowsPowerShell\v1.0\GetEvent.types.ps1xml}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. Eltávolíthatja az aliasokat az exportált aliasok listájából, de nem tud aliasokat hozzáadni a listához.
Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy AliasesToExport kulcsot egy (mind) értékkel * , ami azt jelenti, hogy a modulban definiált összes aliast exportálja a jegyzék.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Author
Megadja a modul szerzőjének értékét.
Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy Author kulcsot az aktuális felhasználó nevével.
| Type: | String |
| Position: | Named |
| Default value: | Name of the current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClrVersion
Meghatározza a Microsoft .NET-keretrendszer common language runtime (CLR) minimális verzióját, amelyet a modul igényel.
Feljegyzés
Ez a beállítás csak a PowerShell Desktop kiadásra érvényes, például a Windows PowerShell 5.1-hez, és csak a 4.5-né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. Eltávolíthatja a parancsmagokat az exportált parancsmagok listájából, de nem tud parancsmagokat hozzáadni a listához.
Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy CmdletsToExport kulcsot egy (mind) értékkel * , ami azt jelenti, hogy a modulban definiált parancsmagokat a jegyzék exportálja.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-CompanyName
Azonosítja a modult létrehozó vállalatot vagy szállítót.
Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy "Ismeretlen" értékű CompanyName kulcsot.
| Type: | String |
| Position: | Named |
| Default value: | "Unknown" |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CompatiblePSEditions
Megadja a modul kompatibilis P Standard kiadás dícióit. A P Standard kiadás dition 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása elő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.
Ha kihagyja ezt a paramétert, létrehoz egy szerzői jogi kulcsot, amelynek értéke <year>(c) <year> <username>. All rights reserved. az aktuális év, és <username> a Szerzői kulcs értéke. New-ModuleManifest
| Type: | String |
| Position: | Named |
| Default value: | (c) <year> <username>. All rights reserved. |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultCommandPrefix
Olyan előtagot ad meg, amely a modul összes parancsának főnevére van előtagként a munkamenetbe való importáláskor. Adjon meg egy előtag-sztringet. Az előtagok megakadályozzák a parancsnevek ütközését egy felhasználó munkamenetében.
A modulfelhasználók felülbírálhatják ezt az előtagot a Import-Module parancsmag előtagparaméterének megadásával.
Ezt a paramétert a PowerShell 3.0-ban vezettük be.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
A modul tartalmát ismerteti.
| 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.
Feljegyzés
Ez a beállítás csak a PowerShell Desktop kiadásra érvényes, például a Windows PowerShell 5.1-hez, és csak a 4.5-né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
Megadja a modul által exportált kívánt állapotkonfigurációs (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
Azoknak a külső moduloknak a listája, amelyektől ez a modul függ.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileList
Megadja a modulban szereplő összes elemet.
Ez a kulcs úgy lett kialakítva, hogy modulleltárként működjön. A kulcsban felsorolt fájlok a modul közzétételekor jelennek meg, de a függvények nem lesznek automatikusan exportálva.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormatsToProcess
Megadja 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. 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.
Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy FunctionsToExport kulcsot egy (mind) értékkel * , ami azt jelenti, hogy a modulban definiált összes függvényt exportálja a jegyzék.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Guid
A modul egyedi azonosítójának megadása. A GUID az azonos nevű modulok megkülönböztetésére használható.
Ha kihagyja ezt a paramétert, létrehoz egy GUID-kulcsot a jegyzékben, New-ModuleManifest és létrehoz egy GUID azonosítótaz értékhez.
Ha új GUID-t szeretne létrehozni a PowerShellben, írja be a következőt [guid]::NewGuid(): .
| Type: | Guid |
| Position: | Named |
| Default value: | A GUID generated for the module |
| 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 vagy https használatával kezdődik.
A HelpInfo XML-fájl támogatja a PowerShell 3.0-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.
Az 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 az Frissíthető súgó támogatása című témakörben talál.
Ezt a paramétert a PowerShell 3.0-ban vezettük be.
| Type: | String |
| 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 weblapján.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleList
Felsorolja a modulban szereplő összes modult.
Adja meg az egyes modulneveket sztringként vagy kivonattábláként a ModuleName és a ModuleVersion kulcsokkal. A kivonatoló tábla opcionális GUID-kulccsal is rendelkezhet. A paraméterértékben sztringeket és kivonattáblákat kombinálhat.
Ez a kulcs úgy lett kialakítva, hogy modulleltárként működjön. 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
Megadja a modul verzióját.
Ez a paraméter nem kötelező, de a jegyzékben egy ModuleVersion-kulcsra van szükség. Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy ModuleVersion-kulcsot 1,0 értékkel.
| Type: | Version |
| Position: | Named |
| Default value: | 1.0 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NestedModules
A modul munkamenet-állapotába importált szkriptmodulokat (.psm1) és bináris modulokat (.dll) adja meg. A Beágyazottmodules kulcs fájljai abban a sorrendben futnak, amelyben szerepelnek az értékben.
Adja meg az egyes modulneveket sztringként vagy kivonattábláként a ModuleName és a ModuleVersion kulcsokkal. A kivonatoló tábla opcionális GUID-kulccsal is rendelkezhet. A paraméterértékben sztringeket és kivonattáblákat kombinálhat.
A beágyazott modulok általában olyan parancsokat tartalmaznak, amelyekre a gyökérmodulnak szüksége van a belső feldolgozáshoz.
Alapértelmezés szerint a beágyazott modulok parancsai a modul munkamenet-állapotából a hívó munkamenet-állapotába lesznek exportálva, de a gyökérmodul korlátozhatja az exportált parancsokat. Például egy Export-ModuleMember parancs használatával.
A modul munkamenet-állapotában lévő beágyazott modulok elérhetők a gyökérmodul számára, de a hívó munkamenetállapotában lévő parancs nem adja vissza Get-Module őket.
A Beágyazottmodules kulcsban felsorolt szkriptek (.ps1) nem a hívó munkamenetállapotában, hanem a modul munkamenet-állapotában futnak. Ha szkriptet szeretne futtatni a hívó munkamenet-állapotában, adja meg a szkriptfájl nevét a jegyzékben lévő ScriptsToProcess kulcs értékében.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Az eredményként kapott moduljegyzéket a konzolra írja, és létrehoz egy .psd1 fájlt. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Megadja az új 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. Az Elérési út paraméter megadása kötelező.
Ha egy meglévő fájl elérési útját adja meg, figyelmeztetés nélkül lecseréli a fájlt, New-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, a jegyzékfájl nevének pedig meg kell egyeznie a modul könyvtárának nevével, de fájlnévkiterjesztéssel .psd1 .
Feljegyzés
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álaszul. Változó használatához adja meg az Elérési út paramétert a parancsban.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PowerShellHostName
Megadja annak a PowerShell-gazdagépprogramnak a nevét, amelyre a modulnak szüksége van. Adja meg a gazdagépprogram nevét, például Windows PowerShell I Standard kiadás Gazdagép vagy ConsoleHost. A 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 |
| 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 az 1.1-et.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PowerShellVersion
A Modullal működő PowerShell minimális verzióját adja meg. Megadhatja például az 1.0, a 2.0 vagy a 3.0 értéket a paraméter értékeként. X.X formátumban kell lennie. Ha például beküldi 5, a PowerShell hibát jelez.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Prerelease
A modul előzetes sztringje. A Prerelease-sztring hozzáadása a modult előzetes verzióként azonosítja. Amikor a modult közzéteszik a PowerShell-galéria, ezek az adatok az előzetes csomagok azonosítására szolgálnak. A katalógusból való előzetes csomagok beszerzéséhez az AllowPrerelease paramétert kell használnia a PowerShellGet parancsokkalFind-Module, Install-ModuleUpdate-Moduleés Save-Module.
| 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: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProcessorArchitecture
Megadja a modul által igényelt processzorarchitektúrát. Az érvényes értékek: x86, AMD64, IA64, MSIL és None (ismeretlen vagy meghatározatlan).
| 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
Kibocsátási megjegyzéseket 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 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 listázhatja a modul által igényelt szerelvényeket, 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 Beágyazottmodulok kulcsban.
| 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 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.
Adja meg az egyes modulneveket sztringként vagy kivonattábláként a ModuleName és a ModuleVersion kulcsokkal. A kivonatoló tábla opcionális GUID-kulccsal is rendelkezhet. A paraméterértékben sztringeket és kivonattáblákat kombinálhat.
A PowerShell 2.0-ban Import-Module nem importálja automatikusan a szükséges modulokat. Csak ellenőrzi, hogy a szükséges modulok globális munkamenet-állapotban vannak-e.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireLicenseAcceptance
Jelző, amely jelzi, hogy a modulnak explicit felhasználói elfogadásra van-e szüksége a telepítéshez, frissítéshez vagy mentéshez.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 (), egy szkriptmodul (.ps1.psm1), egy moduljegyzék(.psd1), egy szerelvény (.dll), egy parancsmagdefiníciós XML-fájl () vagy munkafolyamat (.cdxml.xaml) 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 jegyzékfájllal rendelkezik, és a RootModule kulcsban nem lett kijelölve gyökérfájl, a jegyzékfájl lesz a modul elsődleges fájlja, a modul pedig jegyzékmodul (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ékben szereplő RootModule vagy BeágyazottModules kulcsok értékeiben. Ellenkező esetben a tagok nem lesznek exportálva.
Feljegyzés
A PowerShell 2.0-ban ezt a kulcsot ModuleToProcess-nak hívták. Használhatja a RootModule paraméternevet vagy annak ModuleToProcess aliasát.
| Type: | String |
| Aliases: | ModuleToProcess |
| 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íthet egy környezetet, akárcsak 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
Címkék tömbjének megadása.
| 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 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
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. 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.
Ha kihagyja ezt a paramétert, New-ModuleManifest létrehoz egy VariablesToExport kulcsot egy (mind) értékkel * , ami azt jelenti, hogy a modulban definiált összes változót exportálja a jegyzék.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-WhatIf
Megjeleníti, mi történne, ha New-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
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
A PassThru paraméter használatakor ez a parancsmag egy, a moduljegyzéket képviselő sztringet ad vissza.
Jegyzetek
New-ModuleManifestwindowsos és nem Windows-platformokon futó modulok jegyzékfájljait (.psd1) UTF8NoBOM néven kódolva hozza létre.
A moduljegyzékek általában nem kötelezőek. A globális szerelvény-gyorsítótárban telepített szerelvény exportálásához azonban moduljegyzék szükséges.
Ha fájlokat szeretne hozzáadni vagy módosítani a címtárban, indítsa el a $pshome\Modules PowerShellt a Futtatás rendszergazdaként beállítással.
Feljegyzés
A PowerShell a PowerShell 6.2-től kezdve megpróbálja betölteni a moduljegyzék FileList tulajdonságában felsorolt összes DLL-fájlt. A natív DLL-ek a Fájllistán nem tölthető be a folyamat során, és a hiba figyelmen kívül lesz hagyva. Az összes felügyelt DLL betöltődik a folyamatba. Ez a viselkedés el lett távolítva a PowerShell 7.1-ben.
A PowerShell 2.0-ban számos paraméter New-ModuleManifest kötelező volt, még akkor is, ha nem volt kötelező a moduljegyzékben. A PowerShell 3.0-tól kezdve csak az Elérési út paraméter kötelező.
A munkamenet a PowerShell végrehajtási környezetének egy példánya. A munkamenetek egy vagy több munkamenet-állapotot tartalmazhatnak. Alapértelmezés szerint egy munkamenet csak globális munkamenet-állapottal rendelkezik, de minden importált modul saját munkamenet-állapottal rendelkezik. A munkamenet-állapotok lehetővé teszik, hogy a modul parancsai a globális munkamenet állapotának befolyásolása nélkül fussanak.
A hívó munkamenet-állapota az a munkamenet-állapot, amelybe importál egy modult. Általában a globális munkamenet állapotára utal, de ha egy modul beágyazott modulokat importál, a hívó a modul, a hívó munkamenet-állapota pedig a modul munkamenet-állapota.
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: