De Publish-Module-cmdlet publiceert een module naar een online NuGet-galerie met behulp van een API-sleutel die is opgeslagen als onderdeel van het profiel van een gebruiker in de galerie. U kunt de module opgeven die moet worden gepubliceerd op basis van de naam van de module of door het pad naar de map met de module.
Dit is een proxy-cmdlet voor de Publish-PSResource cmdlet in microsoft.PowerShell.PSResourceGet. Zie Publish-PSResource voor meer informatie.
Voorbeelden
Voorbeeld 1: Een module publiceren
In dit voorbeeld wordt MyDscModule gepubliceerd naar de onlinegalerie met behulp van de API-sleutel om het onlinegalerieaccount van de module-eigenaar aan te geven. Als MyDscModule geen geldige manifestmodule is waarmee een naam, versie, beschrijving en auteur wordt opgegeven, treedt er een fout op.
Voorbeeld 2: Een module publiceren met metagegevens van de galerie
In dit voorbeeld wordt MyDscModule gepubliceerd naar de onlinegalerie met behulp van de API-sleutel om het galerieaccount van de moduleeigenaar aan te geven. De opgegeven aanvullende metagegevens worden weergegeven op de webpagina voor de module in de galerie. De eigenaar voegt twee zoektags toe voor de module, gerelateerd aan Active Directory; er wordt een korte releasenotitie toegevoegd. Als MyDscModule geen geldige manifestmodule is waarmee een naam, versie, beschrijving en auteur wordt opgegeven, treedt er een fout op.
$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
Parameters
-AllowPrerelease
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Publish-PSResource.
Hiermee geeft u de API-sleutel op die u wilt gebruiken om een module te publiceren naar de onlinegalerie. De API-sleutel maakt deel uit van uw profiel in de onlinegalerie en vindt u op de pagina van uw gebruikersaccount in de galerie. De API-sleutel is nuGet-specifieke functionaliteit.
De proxy-cmdlet wijst deze parameter toe aan de ApiKey-parameter van Publish-PSResource.
Hiermee geeft u het pad naar de module die u wilt publiceren. Deze parameter accepteert het pad naar de map die de module bevat. De map moet dezelfde naam hebben als de module.
Hiermee geeft u de beschrijvende naam van een opslagplaats die is geregistreerd door uit te voeren Register-PSRepository. De opslagplaats moet een PublishLocation-hebben. Dit is een geldige NuGet-URI.
De PublishLocation- kan worden ingesteld door Set-PSRepositoryuit te voeren.
PowerShell bevat de volgende aliassen voor Publish-Module:
Alle platforms:
pumo
Publish-Module wordt uitgevoerd op PowerShell 3.0 of hoger van PowerShell, in Windows 7 of Windows 2008 R2 en latere versies van Windows.
De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:
Voor het publiceren van een module zijn metagegevens vereist die worden weergegeven op de galeriepagina voor de module. Vereiste metagegevens bevatten de modulenaam, versie, beschrijving en auteur. De metagegevens moeten worden gedefinieerd in het modulemanifest. Zie Pakketmanifestwaarden die van invloed zijn op de gebruikersinterface van de PowerShell Gallery-voor meer informatie.
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en controleren. Bekijk onze gids voor inzenders voor meer informatie.
