New-ModuleManifest

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>]

Beschreibung

Das New-ModuleManifest Cmdlet erstellt eine neue Modulmanifestdatei (.psd1), füllt ihre Werte auf und speichert die Manifestdatei im angegebenen Pfad.

Modulautoren können dieses Cmdlet verwenden, um ein Manifest für ihr Modul zu erstellen. Ein Modulmanifest ist eine .psd1 Datei, die eine Hashtabelle enthält. Die Schlüssel und Werte in der Hashtabelle beschreiben den Inhalt und die Attribute des Moduls, definieren die erforderlichen Komponenten und bestimmen, wie die Komponenten verarbeitet werden. Manifeste sind für ein Modul nicht erforderlich.

New-ModuleManifest erstellt ein Manifest, das alle häufig verwendeten Manifestschlüssel enthält, sodass Sie die Standardausgabe als Manifestvorlage verwenden können. Um Werte hinzuzufügen oder zu ändern oder Modulschlüssel hinzuzufügen, die von diesem Cmdlet nicht hinzugefügt werden, öffnen Sie die resultierende Datei in einem Text-Editor.

Jeder Parameter mit Ausnahme von Path und PassThru erstellt einen Modulmanifestschlüssel und seinen Wert. In einem Modulmanifest ist nur der ModuleVersion-Schlüssel erforderlich. Sofern sie nicht in der Parameterbeschreibung angegeben ist, wird, wenn Sie einen Parameter aus dem Befehl weglassen, New-ModuleManifest eine Kommentarzeichenfolge für den zugeordneten Wert erstellt, der keine Auswirkung hat.

In PowerShell 2.0 werden Sie aufgefordert, New-ModuleManifest die Werte häufig verwendeter Parameter anzugeben, die nicht im Befehl angegeben sind, zusätzlich zu den erforderlichen Parameterwerten. Ab PowerShell 3.0 werden Aufforderungen nur angezeigt, New-ModuleManifest wenn erforderliche Parameterwerte nicht angegeben werden.

Wenn Sie planen, Ihr Modul im PowerShell-Katalog zu veröffentlichen, muss das Manifest Werte für bestimmte Eigenschaften enthalten. Weitere Informationen finden Sie unter Erforderliche Metadaten für Elemente, die im PowerShell-Katalog in der Katalogdokumentation veröffentlicht wurden.

Beispiele

Beispiel 1 : Erstellen eines neuen Modulmanifests

In diesem Beispiel wird ein neues Modulmanifest in der Datei erstellt, die durch den Path-Parameter angegeben wird. Der PassThru-Parameter sendet die Ausgabe an die Pipeline und an die Datei.

Die Ausgabe zeigt die Standardwerte aller Schlüssel im Manifest.

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 = ''

}

Beispiel 2 : Erstellen eines neuen Manifests mit einigen vorab aufgefüllten Einstellungen

In diesem Beispiel wird ein neues Modulmanifest erstellt. Es verwendet die Parameter PowerShellVersion und AliasesToExport , um den entsprechenden Manifestschlüsseln Werte hinzuzufügen.

$moduleSettings = @{
    PowerShellVersion = 1.0
    Path   = 'C:\ps-test\ManifestTest.psd1'
    AliasesToExport   = @(
      'JKBC'
      'DRC'
      'TAC'
    )
}
New-ModuleManifest @moduleSettings

Beispiel 3 : Erstellen eines Manifests, das andere Module erfordert

In diesem Beispiel wird ein Zeichenfolgenformat verwendet, um den Namen des BitsTransfer-Moduls und das Hashtabellenformat anzugeben, um den Namen, eine GUID und eine Version des PSScheduledJob-Moduls anzugeben.

$moduleSettings = @{
  RequiredModules = ("BitsTransfer", @{
    ModuleName="PSScheduledJob"
    ModuleVersion="1.0.0.0";
    GUID="50cdb55f-5ab7-489f-9e94-4ec21ff51e59"
  })
  Path = 'C:\ps-test\ManifestTest.psd1'
}
New-ModuleManifest @moduleSettings

In diesem Beispiel wird gezeigt, wie Sie die Zeichenfolgen- und Hashtabellenformate des Parameters ModuleList, RequiredModules und NestedModules verwenden. Sie können Zeichenfolgen und Hashtabellen in demselben Parameterwert kombinieren.

Beispiel 4 – Erstellen eines Manifests, das aktualisierbare Hilfe unterstützt

In diesem Beispiel wird der HelpInfoUri-Parameter verwendet, um einen HelpInfoUri-Schlüssel im Modulmanifest zu erstellen. Der Wert des Parameters und des Schlüssels muss mit http oder https beginnen. Dieser Wert zeigt dem „Aktualisierbare Hilfe“-System, wo die HelpInfo-XML-Informationsdatei für das Modul zu finden ist.

$moduleSettings = @{
  HelpInfoUri = 'http://https://go.microsoft.com/fwlink/?LinkID=603'
  Path = 'C:\ps-test\ManifestTest.psd1'
}
New-ModuleManifest @moduleSettings

Informationen zur aktualisierbaren Hilfe finden Sie unter about_Updatable_Help. Informationen zur XML-Datei "HelpInfo" finden Sie unter "Unterstützende aktualisierbare Hilfe".

Beispiel 5 – Abrufen von Modulinformationen

In diesem Beispiel wird gezeigt, wie Die Konfigurationswerte eines Moduls abgerufen werden. Die Werte im Modulmanifest werden in den Werten der Eigenschaften des Modulobjekts wiedergegeben.

Das Get-Module Cmdlet wird verwendet, um das Modul "Microsoft.PowerShell.Diagnostics " mithilfe des List-Parameters abzurufen. Der Befehl sendet das Modul an das Format-List Cmdlet, um alle Eigenschaften und Werte des Modulobjekts anzuzeigen.

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}

Parameter

-AliasesToExport

-Author

-ClrVersion

-CmdletsToExport

-CompanyName

-CompatiblePSEditions

-Confirm

-Copyright

-DefaultCommandPrefix

-Description

-DotNetFrameworkVersion

-DscResourcesToExport

-ExternalModuleDependencies

-FileList

-FormatsToProcess

-FunctionsToExport

-Guid

-HelpInfoUri

-IconUri

-LicenseUri

-ModuleList

-ModuleVersion

-NestedModules

-PassThru

-Path

-PowerShellHostName

-PowerShellHostVersion

-PowerShellVersion

-Prerelease

-PrivateData

-ProcessorArchitecture

-ProjectUri

-ReleaseNotes

-RequiredAssemblies

-RequiredModules

-RequireLicenseAcceptance

-RootModule

-ScriptsToProcess

-Tags

-TypesToProcess

-VariablesToExport

-WhatIf

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

String

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet eine Zeichenfolge zurück, die das Modulmanifest darstellt.

Hinweise

New-ModuleManifest unter Windows und Nicht-Windows-Plattformen werden Modulmanifestdateien (.psd1) erstellt, die als UTF8NoBOM codiert sind.

Modulmanifeste sind normalerweise optional. Ein Modulmanifest ist jedoch erforderlich, wenn Sie eine Assembly exportieren möchten, die im globalen Assemblycache installiert ist.

Um Dateien im $pshome\Modules Verzeichnis hinzuzufügen oder zu ändern, starten Sie PowerShell mit der Option "Als Administrator ausführen".

In PowerShell 2.0 waren viele Parameter New-ModuleManifest obligatorisch, obwohl sie in einem Modulmanifest nicht erforderlich waren. Ab PowerShell 3.0 ist nur der Path-Parameter obligatorisch.

Eine Sitzung ist eine Instanz der PowerShell-Ausführungsumgebung. Eine Sitzung kann mindestens einen Sitzungsstatus haben. Standardmäßig weist eine Sitzung nur einen globalen Sitzungsstatus auf, jedes importierte Modul verfügt jedoch über einen eigenen Sitzungsstatus. Sitzungsstatus erlauben das Ausführen der Befehle in einem Modul, ohne den globalen Sitzungsstatus zu beeinflussen.

Der Sitzungsstatus des Aufrufers ist der Sitzungszustand, in den ein Modul importiert wird. In der Regel bezieht es sich auf den globalen Sitzungszustand, aber wenn ein Modul geschachtelte Module importiert, ist der Aufrufer das Modul, und der Sitzungszustand des Aufrufers ist der Sitzungszustand des Moduls.

Ähnliche Themen

• Export-ModuleMember
• Get-Module
• Import-Module
• New-Module
• Remove-Module
• Test-ModuleManifest
• about_Modules