Il cmdlet Publish-Module pubblica un modulo in una raccolta basata su NuGet online usando una chiave API archiviata come parte del profilo di un utente nella raccolta. È possibile specificare il modulo da pubblicare in base al nome del modulo o al percorso della cartella contenente il modulo.
Si tratta di un cmdlet proxy per il Publish-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Publish-PSResource.
Esempio
Esempio 1: Pubblicare un modulo
In questo esempio MyDscModule viene pubblicato nella raccolta online usando la chiave API per indicare l'account della raccolta online del proprietario del modulo. Se MyDscModule non è un modulo manifesto valido che specifica un nome, una versione, una descrizione e un autore, si verifica un errore.
Esempio 2: Pubblicare un modulo con i metadati della raccolta
In questo esempio MyDscModule viene pubblicato nella raccolta online usando la chiave API per indicare l'account della raccolta del proprietario del modulo. I metadati aggiuntivi forniti vengono visualizzati nella pagina Web del modulo nella raccolta. Il proprietario aggiunge due tag di ricerca per il modulo, correlati ad Active Directory; viene aggiunta una breve nota sulla versione. Se MyDscModule non è un modulo manifesto valido che specifica un nome, una versione, una descrizione e un autore, si verifica un errore.
$parameters = @{
Path = 'c:\projects\MyDscModule\1.0.0'
NuGetApiKey = '11e4b435-6cb4-4bf7-8611-5162ed75eb73'
LicenseUri = 'http://contoso.com/license'
Tag = 'Active Directory','DSC'
ReleaseNote = 'Updated the ActiveDirectory DSC Resources to support adding users.'
}
Publish-Module @parameters
Parametri
-AllowPrerelease
Il cmdlet proxy ignora questo parametro perché non è supportato da Publish-PSResource.
Valore dalla pipeline in base al nome della proprietà:
True
Valore dagli argomenti rimanenti:
False
-NuGetApiKey
Specifica la chiave API da usare per pubblicare un modulo nella raccolta online. La chiave API fa parte del profilo nella raccolta online e si trova nella pagina dell'account utente nella raccolta. La chiave API è una funzionalità specifica di NuGet.
Il cmdlet proxy esegue il mapping di questo parametro al parametro ApiKey di Publish-PSResource.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Path
Specifica il percorso del modulo da pubblicare. Questo parametro accetta il percorso della cartella che contiene il modulo. La cartella deve avere lo stesso nome del modulo.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Repository
Specifica il nome descrittivo di un repository registrato eseguendo Register-PSRepository. Il repository deve avere un PublishLocation, che è un URI NuGet valido.
È possibile impostare PublishLocation eseguendo Set-PSRepository.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
PowerShell include gli alias seguenti per Publish-Module:
Tutte le piattaforme:
pumo
Publish-Module viene eseguito in PowerShell 3.0 o versioni successive di PowerShell, in Windows 7 o Windows 2008 R2 e versioni successive di Windows.
PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Usare il comando seguente per assicurarsi di usare TLS 1.2:
La pubblicazione di un modulo richiede metadati visualizzati nella pagina della raccolta per il modulo. I metadati obbligatori includono il nome del modulo, la versione, la descrizione e l'autore. I metadati devono essere definiti nel manifesto del modulo. Per altre informazioni, vedere valori del manifesto del pacchetto che influisce sull'interfaccia utente di PowerShell Gallery.
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
