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-PSModuleManifestParametri
-AliasesToExport
Specifica gli alias esportati dal modulo. I caratteri jolly sono consentiti.
| 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.
| 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.
| 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 |
-Copyright
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.
| 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: | True |
-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) 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.
| 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.
| 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 viene usato per distinguere tra i 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:.
Per altre informazioni, vedere Guida aggiornabile.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IconUri
Specifica l'URI 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 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.
| 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.
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.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Specifica il percorso e il nome file del manifesto del modulo. Immettere il nome del file con un'estensione .psd1 di file.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| 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.
Il nome di un programma host viene archiviato in $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 funziona con questo modulo. Ad esempio, è possibile specificare versioni come 5.1 o 7.2.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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. Questo può essere qualsiasi valore arbitrario archiviato in una tabella hash.
| 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:
Amd64ArmIA64MSILNone(sconosciuto o non specificato)X86
| Type: | ProcessorArchitecture |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProjectUri
Specifica l'URI di una pagina Web su questo progetto.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReleaseNotes
Specifica una stringa che contiene note sulla versione o commenti per il modulo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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.
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.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireLicenseAcceptance
Specifica che per il modulo è necessaria un'accettazione della licenza.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 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 (), 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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[] |
| Aliases: | Tag |
| 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
Input
None
Output
Note
Per una descrizione completa del file manifesto del modulo, vedere about_Module_Manifests.
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per