Update ModuleManifestUpdate-ModuleManifest

Updates van een manifestbestand van de module.Updates a module manifest file.

BeschrijvingDescription

Een module-manifest (.psd1)-bestand wordt bijgewerkt door de cmdlet Update-ModuleManifest.The Update-ModuleManifest cmdlet updates a module manifest (.psd1) file.

OpmerkingenNotes

- <span data-ttu-id="97fc5-108">DscResourcesToExport wordt alleen ondersteund op de meest recente versie 5.0-PowerShell.</span><span class="sxs-lookup"><span data-stu-id="97fc5-108">DscResourcesToExport is only supported on the latest PowerShell version 5.0.</span></span> <span data-ttu-id="97fc5-109">We niet mogelijk om te werken van het veld als u op een lagere versie van PowerShell uitvoert.</span><span class="sxs-lookup"><span data-stu-id="97fc5-109">We won’t be able to update the field if you are running on lower versions of PowerShell.</span></span>

De syntaxis van cmdletCmdlet syntax

Get-Command -Name Update-ModuleManifest -Module PowerShellGet -Syntax

Verwijzing naar het online help van cmdletCmdlet online help reference

Update ModuleManifestUpdate-ModuleManifest

VoorbeeldopdrachtenExample commands

Deze nieuwe cmdlet wordt gebruikt om te manifestbestand met invoer eigenschapswaarden update.This new cmdlet is used to help update manifest file with input property values. Het duurt alle parameters die nieuw ModuleManifest biedt.It takes all parameters that New-ModuleManifest does.

We merken dat veel van de module auteurs wilt opgeven '*' in de geëxporteerde waarden zoals FunctionsToExport, CmdletsToExport, enz. Tijdens de publicatie van de module voor PowerShell Gallery, niet-opgegeven functies en opdrachten niet ingevuld correct naar de galerie.We notice that a lot of module authors would like to specify “*” in exported values such as FunctionsToExport, CmdletsToExport, etc. During module publishing to PowerShell Gallery, unspecified functions and commands will not be populated properly onto the Gallery. Daarom raden we module auteurs update hun manifesten met de juiste waarden.Therefore, we suggest module authors update their manifests with proper values.

Als u hebt de modules die eigenschappen hebt geëxporteerd, vult Update ModuleManifest in het opgegeven manifestbestand met gegevens van geëxporteerde functies, -cmdlets, variabelen enzovoort:If you have modules that have exported properties, Update-ModuleManifest will fill the specified manifest file with information from exported functions, cmdlets, variables etc:

Get-Content -Path "C:\Temp\PSGTEST-TestPackageMetadata\2.5\PSGTEST-TestPackageMetadata.psd1"
@{
# Script module or binary module file associated with this manifest.
# RootModule = ''
# Version number of this module.
ModuleVersion = '2.5'
# ID used to uniquely identify this module
GUID = '610e5c5b-dc42-4eaa-8511-ebfb44066d5e'

#(Other properties removed here for Simplicity…)

# Functions to export from this module
FunctionsToExport = '*'
# Cmdlets to export from this module
CmdletsToExport = '*'
# Variables to export from this module
VariablesToExport = '*'
# Aliases to export from this module
AliasesToExport = '*'
}

Na de Update-ModuleManifest:After Update-ModuleManifest:

Update-ModuleManifest -Path "C:\Temp\PSGTEST-TestPackageMetadata\2.5\PSGTEST-TestPackageMetadata.psd1"
Get-Content -Path "C:\Temp\PSGTEST-TestPackageMetadata\2.5\PSGTEST-TestPackageMetadata.psd1"
#
# Module manifest for module 'NewManifest'
#
# Generated by: author name
#
# Generated on: 11/13/2015
#
@{
# Script module or binary module file associated with this manifest.
# RootModule = ''
# Version number of this module.
ModuleVersion = '2.5'
# ID used to uniquely identify this module
GUID = '610e5c5b-dc42-4eaa-8511-ebfb44066d5e'
# Functions to export from this module
FunctionsToExport = 'Get-FooFn Get-FooWF'
# Cmdlets to export from this module
CmdletsToExport = 'Test-PSGetTestCmdlet'
}

Voor elke module er zijn ook metagegevensvelden gekoppeld.For each module, there are also metadata fields associated with it. Om metagegevens correct weergegeven op PowrShell galerie, kunt u Update ModuleManifest onder PrivateData deze velden te vullen.In order to display metadata properly on PowrShell Gallery, you can use Update-ModuleManifest to populate those fields under PrivateData.

Update-ModuleManifest -Path "C:\Temp\PSGTEST-TestPackageMetadata\2.5\PSGTEST-TestPackageMetadata.psd1" -Tags "Tag1" -LicenseUri "http://license.com" -ProjectUri "http://project.com" -IconUri "http://icon.com" -ReleaseNotes "Test module"

PrivateData hashtabel van de sjabloon manifestbestand heeft de volgende eigenschappenPrivateData hashtable from the manifest file template has the following properties

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

        # External dependent modules of this module
        # ExternalModuleDependencies = ''
    } # End of PSData hashtable
} # End of PrivateData hashtable