Update-PSModuleManifest

Aggiorna un file manifesto del modulo.

Sintassi

Update-PSModuleManifest
      [-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[]>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String>]
      [-Prerelease <String>]
      [-HelpInfoUri <Uri>]
      [-DefaultCommandPrefix <String>]
      [-ExternalModuleDependencies <String[]>]
      [-RequireLicenseAcceptance]
      [-PrivateData <Hashtable>]
      [<CommonParameters>]

Descrizione

Questo cmdlet aggiorna i dati archiviati in un file manifesto del modulo. I parametri consentono di specificare quali proprietà vengono aggiornate. Update-PSModuleManifest sovrascrive tutti i valori esistenti nel manifesto del modulo.

Il cmdlet non restituisce un oggetto.

Esempio

Esempio 1

In questo esempio viene modificata la proprietà Author nel manifesto del modulo in New Author.

Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'

Esempio 2

In questo esempio la proprietà Prerelease viene modificata in beta2.

Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'

Esempio 3

In questo esempio vengono aggiornate più proprietà.

$parameters = @{
    Path = 'C:\MyModules\TestModule'
    Tags = 'Windows', 'Linux'
    Description = 'A module for managing packages.'
}
Update-PSModuleManifest

Parametri

-AliasesToExport

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Author

Specifica l'autore del modulo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClrVersion

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

Tipo:Version
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CmdletsToExport

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-CompanyName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CompatiblePSEditions

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

Tipo:String[]
Valori accettati:Desktop, Core
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Specifica le informazioni di copyright per il modulo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultCommandPrefix

Specifica il prefisso del comando predefinito.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione del modulo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DotNetFrameworkVersion

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

Tipo:Version
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DscResourcesToExport

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-ExternalModuleDependencies

Specifica una matrice di dipendenze del modulo esterno.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FileList

Specifica tutti gli elementi inclusi nel modulo.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FormatsToProcess

Specifica i file di formattazione (.ps1xml) elaborati 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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FunctionsToExport

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Guid

Specifica un identificatore univoco per il modulo. Il GUID viene usato per distinguere tra i moduli con lo stesso nome.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HelpInfoUri

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

Per altre informazioni, vedere Guida aggiornabile.

Tipo:Uri
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IconUri

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

Tipo:Uri
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LicenseUri

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

Tipo:Uri
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ModuleList

Specifica una matrice di moduli inclusi nel modulo.

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

Questa chiave è progettata per agire come inventario di modulo.

Tipo:Object[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ModuleVersion

Specifica la versione del modulo.

Tipo:Version
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

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

Tipo:Object[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso e il nome file del manifesto del modulo. Immettere il nome del file con un'estensione .psd1 di file.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Il nome di un programma host viene archiviato in $Host.Name.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Version
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PowerShellVersion

Specifica la versione minima di PowerShell che funziona con questo modulo. Ad esempio, è possibile specificare versioni come 5.1 o 7.2.

Tipo:Version
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Prerelease

Specifica il valore di versione preliminare aggiunto alla versione del modulo. Ad esempio, se La versione preliminare è e ModuleVersion è preview , la versione del modulo è 1.0.0-preview1.0.0.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrivateData

Specifica i dati passati al modulo quando viene importato. Questo può essere qualsiasi valore arbitrario archiviato in una tabella hash.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProcessorArchitecture

Specifica l'architettura del processore richiesta dal modulo.

I valori validi per questo parametro sono:

  • Amd64
  • Arm
  • IA64
  • MSIL
  • None (sconosciuto o non specificato)
  • X86
Tipo:ProcessorArchitecture
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProjectUri

Specifica l'URI di una pagina Web su questo progetto.

Tipo:Uri
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReleaseNotes

Specifica una stringa che contiene note sulla versione o commenti per il modulo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequiredAssemblies

Specifica i file assembly (.dll) richiesti dal modulo. PowerShell carica gli assembly specificati prima di aggiornare tipi o formati, importare moduli annidati o importare il file di modulo specificato nella chiave RootModule .

Usare RequiredAssemblies per gli assembly che devono essere caricati per aggiornare eventuali file di formattazione o di tipo elencati nelle chiavi FormatToProcess o TypesToProcess, anche se tali assembly sono elencati anche nella chiave NestedModules.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Il valore può essere una matrice contenente nomi di moduli o specifiche del modulo. Una specifica del modulo è una tabella hash con le chiavi seguenti.

  • ModuleName - Obbligatorio Specifica il nome del modulo.
  • GUID - Opzionale Specifica il GUID del modulo.
  • È anche necessario specificare almeno una delle tre chiavi seguenti.
    • ModuleVersion - Specifica una versione minima accettabile del modulo.
    • MaximumVersion - Specifica la versione massima accettabile del modulo.
    • RequiredVersion - Specifica una versione esatta e obbligatoria del modulo. Questa operazione non può essere usata con le altre chiavi Versione.
Tipo:Object[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequireLicenseAcceptance

Specifica che per il modulo è necessaria un'accettazione della licenza.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RootModule

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

Se un modulo ha un file manifesto e non viene specificato alcun file nella chiave RootModule , il manifesto diventa il file primario per il modulo. Il modulo è noto come modulo manifesto (ModuleType = Manifest).

Per esportare i membri da .psm1 o .dll file, i nomi di tali file devono essere specificati nei valori delle chiavi RootModule o NestedModules nel manifesto.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScriptsToProcess

Specifica i file script (.ps1) eseguiti nello stato della 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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tags

Specifica una matrice di tag.

Tipo:String[]
Alias:Tag
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VariablesToExport

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

Usare questo parametro per limitare le variabili esportate dal modulo.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

None

Output

Object

Note

Per una descrizione completa del file manifesto del modulo, vedere about_Module_Manifests.