Condividi tramite


Update-ModuleManifest

Aggiorna un file manifesto del modulo.

Sintassi

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

Descrizione

Il Update-ModuleManifest cmdlet aggiorna un file manifesto del modulo (.psd1).

Questo è un cmdlet proxy per il Update-PSModuleManifest cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Update-PSModuleManifest.

Esempio

Esempio 1: Aggiornare un manifesto del modulo

In questo esempio viene aggiornato un file manifesto del modulo esistente. Splatting viene usato per passare i valori dei parametri a Update-ModuleManifest. Per altre informazioni, vedere 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 è una splat che archivia i valori dei parametri per Path, Author, CompanyName e Copyright. Update-ModuleManifest ottiene i valori dei parametri da @Params e aggiorna il manifesto del modulo, TestManifest.psd1.

Parametri

-AliasesToExport

Specifica gli alias esportati dal modulo. I caratteri jolly sono consentiti.

Usare questo parametro per limitare gli alias esportati dal modulo. AliasesToExport può rimuovere gli alias dall'elenco degli alias esportati, ma non può aggiungere alias all'elenco.

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

-Author

Specifica l'autore del modulo.

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

-ClrVersion

Specifica la versione minima di Common Language Runtime (CLR) di Microsoft .NET Framework richiesta dal modulo.

Nota

Questa impostazione è valida solo per l'edizione di PowerShell Desktop, ad esempio Windows PowerShell 5.1 e si applica solo alle versioni di .NET Framework inferiori a 4.5. Questo requisito non ha alcun effetto per le versioni più recenti di PowerShell o .NET Framework.

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

-CmdletsToExport

Specifica i cmdlet esportati dal modulo. I caratteri jolly sono consentiti.

Usare questo parametro per limitare i cmdlet esportati dal modulo. I cmdletToExport possono rimuovere i cmdlet dall'elenco dei cmdlet esportati, ma non è possibile aggiungere cmdlet all'elenco.

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

-CompanyName

Specifica l'azienda o il fornitore che ha creato il modulo.

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

-CompatiblePSEditions

Specifica le PSEditions compatibili del modulo. Per informazioni su PSEdition, vedere Moduli con edizioni di PowerShell compatibili.

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

-Confirm

Richiede la conferma prima dell'esecuzione Update-ModuleManifestdi .

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

Specifica le informazioni di copyright per il modulo.

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

-DefaultCommandPrefix

Specifica il prefisso del comando predefinito.

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

-Description

Specifica una descrizione del modulo.

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

-DotNetFrameworkVersion

Specifica la versione minima di Microsoft .NET Framework richiesta dal modulo.

Nota

Questa impostazione è valida solo per l'edizione di PowerShell Desktop, ad esempio Windows PowerShell 5.1 e si applica solo alle versioni di .NET Framework inferiori a 4.5. Questo requisito non ha alcun effetto per le versioni più recenti di PowerShell o .NET Framework.

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

-DscResourcesToExport

Specifica le risorse Desired State Configuration (DSC) esportate dal modulo. I caratteri jolly sono consentiti.

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

-ExternalModuleDependencies

Specifica una matrice di dipendenze del modulo esterno.

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

-FileList

Specifica tutti gli elementi inclusi nel modulo.

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

-FormatsToProcess

Specifica i file di formattazione (.ps1xml) eseguiti quando il modulo viene importato.

Quando si importa un modulo, PowerShell esegue il Update-FormatData cmdlet con i file specificati. Poiché la formattazione dei file non è con ambito, influiscono su tutti gli stati della sessione.

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

-FunctionsToExport

Specifica le funzioni esportate dal modulo. I caratteri jolly sono consentiti.

Usare questo parametro per limitare le funzioni esportate dal modulo. FunctionsToExport può rimuovere le funzioni dall'elenco degli alias esportati, ma non può aggiungere funzioni all'elenco.

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

-Guid

Specifica un identificatore univoco per il modulo. Il GUID può essere usato per distinguere i diversi moduli con lo stesso nome.

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

-HelpInfoUri

Specifica l'indirizzo Internet del file XML HelpInfo del modulo. Immettere un URI (Uniform Resource Identifier) che inizia con http o https.

Il file XML HelpInfo supporta la funzionalità Guida aggiornabile introdotta in PowerShell versione 3.0. Contiene informazioni sul percorso dei file della Guida scaricabili del modulo e sui numeri di versione dei file della Guida più recenti per ogni impostazione locale supportata.

Per informazioni sulla Guida aggiornabile, vedere about_Updatable_Help. Per informazioni sul file XML HelpInfo , vedere Supporto della Guida aggiornabile.

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

-IconUri

Specifica l'URL di un'icona per il modulo. L'icona specificata viene visualizzata nella pagina Web della raccolta per il modulo.

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

-LicenseUri

Specifica l'URL delle condizioni di licenza per il modulo.

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

-ModuleList

Specifica una matrice di moduli inclusi nel modulo.

Immettere ogni nome di modulo come stringa o tabella hash con chiavi ModuleName e ModuleVersion. La tabella hash può avere anche una chiave GUID facoltativa. È possibile combinare stringhe e tabelle hash nel valore del parametro.

Questa chiave è progettata per agire come inventario di modulo. I moduli elencati nel valore di questa chiave non vengono elaborati automaticamente.

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

-ModuleVersion

Specifica la versione del modulo.

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

-NestedModules

Specifica i moduli script () e i moduli binari (.psm1.dll) importati nello stato della sessione del modulo. I file nella chiave NestedModules vengono eseguiti nell'ordine in cui sono elencati nel valore.

Immettere ogni nome di modulo come stringa o tabella hash con chiavi ModuleName e ModuleVersion. La tabella hash può avere anche una chiave GUID facoltativa. È possibile combinare stringhe e tabelle hash nel valore del parametro.

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

-PackageManagementProviders

Specifica una matrice di provider di gestione dei pacchetti.

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

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, Update-ModuleManifest non genera alcun output.

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

-Path

Specifica il percorso e il nome del file del manifesto del modulo. Immettere un percorso e un nome file con un'estensione .psd1 del nome file, ad esempio $PSHOME\Modules\MyModule\MyModule.psd1.

Se si specifica il percorso di un file esistente, Update-ModuleManifest sostituisce il file senza avviso a meno che il file non abbia l'attributo di sola lettura.

Il manifesto deve trovarsi nella directory del modulo e il nome del file manifesto deve essere uguale al nome della directory del modulo, ma con un'estensione .psd1 .

Non è possibile usare variabili, ad esempio $PSHOME o $HOME, in risposta a una richiesta di un valore del parametro Path . Per usare una variabile, includere il parametro Path nel comando.

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

-PowerShellHostName

Specifica il nome del programma host di PowerShell richiesto dal modulo. Immettere il nome del programma host, ad esempio Host ISE di PowerShell o ConsoleHost. I caratteri jolly non sono consentiti.

Per trovare il nome di un programma host, nel programma digitare $Host.Name.

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

-PowerShellHostVersion

Specifica la versione minima del programma host di PowerShell che funziona con il modulo. Immettere un numero di versione, ad esempio 1.1.

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

-PowerShellVersion

Specifica la versione minima di PowerShell che funzionerà con questo modulo. Ad esempio, è possibile specificare 3.0, 4.0 o 5.0 come valore di questo parametro.

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

-Prerelease

Indica che il modulo è in versione preliminare.

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

-PrivateData

Specifica i dati passati al modulo quando viene importato.

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

-ProcessorArchitecture

Specifica l'architettura del processore richiesta dal modulo.

I valori validi per questo parametro sono:

  • Amd64
  • Arm
  • IA64
  • MSIL
  • Nessuno (sconosciuto o non specificato)
  • 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

Specifica l'URL di una pagina Web relativa a questo progetto.

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

-ReleaseNotes

Specifica una matrice di stringhe che contiene note sulla versione o commenti desiderati per questa versione dello script.

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

-RequiredAssemblies

Specifica i file assembly (.dll) necessari per il modulo. Immettere i nomi dei file di assembly. PowerShell carica gli assembly specificati prima di aggiornare tipi o formati, importare moduli annidati o importare il file di modulo specificato nel valore della chiave RootModule .

Utilizzare questo parametro per specificare tutti gli assembly richiesti dal modulo, inclusi gli assembly che devono essere caricati per aggiornare tutti i file di formattazione o di tipo elencati nelle chiavi FormatsToProcess o TypesToProcess , anche se tali assembly sono elencati anche come moduli binari nella chiave NestedModules .

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

-RequiredModules

Specifica i moduli che devono essere nello stato sessione globale. Se i moduli necessari non sono nello stato della sessione globale, PowerShell li importa. Se i moduli necessari non sono disponibili, il Import-Module comando ha esito negativo.

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

-RequireLicenseAcceptance

Specifica che per il modulo è necessaria l'accettazione di una licenza.

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

-RootModule

Specifica il file primario o radice del modulo. Immettere il nome file di uno script (.ps1), un modulo script (.psm1), un manifesto del modulo (), un assembly (.psd1.dll), un file XML di definizione del cmdlet (.cdxml) o un flusso di lavoro (.xaml). Quando viene importato il modulo, i membri esportati dal file radice del modulo vengono importati nello stato sessione del chiamante.

Se un modulo ha un file manifesto e non è stato specificato alcun file radice nella chiave RootModule , il manifesto diventa il file primario per il modulo. E il modulo diventa un modulo manifesto (ModuleType = Manifesto).

Per esportare membri da .psm1 o .dll file in un modulo con un manifesto, i nomi di tali file devono essere specificati nei valori delle chiavi RootModule o NestedModules nel manifesto. In caso contrario, i relativi membri non vengono esportati.

In PowerShell 2.0 questa chiave è stata denominata ModuleToProcess.

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

-ScriptsToProcess

Specifica i file di script (.ps1) eseguiti nello stato di sessione del chiamante quando il modulo viene importato. È possibile usare questi script per preparare un ambiente o per usare uno script di accesso.

Per specificare script eseguiti nello stato sessione del modulo, usare la chiave NestedModules.

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

-Tags

Specifica una matrice di tag.

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

-TypesToProcess

Specifica i file di tipo (.ps1xml) eseguiti quando il modulo viene importato.

Quando si importa il modulo, PowerShell esegue il Update-TypeData cmdlet con i file specificati. Poiché i file di tipo non hanno ambito, influiscono su tutti gli stati della sessione.

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

-VariablesToExport

Specifica le variabili esportate dal modulo. I caratteri jolly sono consentiti.

Usare questo parametro per limitare le variabili esportate dal modulo. VariablesToExport può rimuovere le variabili dall'elenco delle variabili esportate, ma non può aggiungere variabili all'elenco.

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

-WhatIf

Mostra cosa accadrebbe se Update-ModuleManifest viene eseguito. Il cmdlet non viene eseguito.

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

Input

String

Output

Object