Update-PSModuleManifest

Riferimento

Modulo:: Microsoft.PowerShell.PSResourceGet

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 viene modificata la proprietà versione preliminare 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 che il modulo esporta. Sono consentiti caratteri jolly.

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 che il modulo esporta. Sono consentiti caratteri jolly.

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

-CompanyName

Specifica la società 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 compatibili PSEditions del modulo. Per informazioni su PSEdition, vedere Modules with compatible PowerShell Editions.

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

-Copyright

Specifica un'informativa sul 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 DSC (Desired State Configuration) esportate dal modulo. Sono consentiti caratteri jolly.

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 cmdlet Update-FormatData con i file specificati. Poiché la formattazione dei file non ha ambito, influiscono su tutti gli stati della sessione nella 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. Sono consentiti caratteri jolly.

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 di modulo come stringa o come tabella hash con ModuleName e ModuleVersion chiavi. La tabella hash può anche avere un GUID facoltativo chiave. È possibile combinare stringhe e tabelle hash nel valore del parametro.

Questa chiave è progettata per fungere da inventario dei moduli.

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 di script (.psm1) e i moduli binari (.dll) importati nello stato della sessione del modulo. I file nel NestedModules chiave vengono eseguiti nell'ordine in cui sono elencati.

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 filename con un'estensione di file .psd1.

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 non definitiva aggiunto alla versione del modulo. Ad esempio, se versione preliminare è preview e la ModuleVersion è 1.0.0, la versione del modulo è 1.0.0-preview.

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 vengono importati. Può trattarsi di 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 accettabili 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 relativa a 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 contenente 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 di 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.

Utilizzare RequiredAssemblies per gli assembly che devono essere caricati per aggiornare tutti i file di formattazione o di tipo elencati nella FormatsToProcess o TypesToProcess chiavi, 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 trovarsi nello stato della sessione globale. Se i moduli necessari non sono nello stato della sessione globale, PowerShell li importa. Se i moduli necessari non sono disponibili, il comando Import-Module ha esito negativo.

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

ModuleName - Obbligatorio Specifica il nome del modulo.
GUID - Facoltativo Specifica il GUID del modulo.
È anche Obbligatorio 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. Non è possibile usare questa opzione con le altre chiavi di 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 (.ps1), un modulo script (.psm1), un manifesto del modulo (.psd1), un assembly (.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 file .psm1 o .dll, i nomi di tali file devono essere specificati nei valori del RootModule o chiavi 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, proprio come è possibile usare uno script di accesso.

Per specificare gli script eseguiti nello stato della 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 cmdlet Update-TypeData 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. Sono consentiti caratteri jolly.

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.

New-ModuleManifest

Condividi tramite