Functions/Publish-IBHGallery.ps1
|
<#
.SYNOPSIS Publish the module to the PowerShell Gallery. .DESCRIPTION Use the build-in Publish-Module command to publish a new module version including the release notes. .OUTPUTS None. No output if successful or an exception in case of an error. .EXAMPLE PS C:\> Publish-IBHGallery -BuildRoot 'C:\GitHub\InvokeBuildHelper' -ModuleName 'InvokeBuildHelper' -ModuleVersion '1.0.0' -GalleryName 'PSGallery' -GalleryUser $user -GalleryToken $token Publish the module InvokeBuildHelper version 1.0.0 to the PSGallery. .LINK https://github.com/claudiospizzi/InvokeBuildHelper #> function Publish-IBHGallery { [CmdletBinding()] param ( # Root path of the project. [Parameter(Mandatory = $true)] [System.String] $BuildRoot, # Name of the module. [Parameter(Mandatory = $true)] [System.String] $ModuleName, # Version to publish. [Parameter(Mandatory = $true)] [System.String] $ModuleVersion, # Gallery name. [Parameter(Mandatory = $true)] [System.String] $GalleryName, # Gallery user. [Parameter(Mandatory = $true)] [AllowEmptyString()] [System.String] $GalleryUser, # Gallery token. [Parameter(Mandatory = $true)] [System.Security.SecureString] $GalleryToken ) $releaseNotes = Get-IBHModuleReleaseNote -BuildRoot $BuildRoot -ModuleVersion $ModuleVersion if ($GalleryToken.Length -eq 0) { if (-not [System.String]::IsNullOrEmpty($GalleryUser)) { $targetName = 'IBH {0} Token ({1})' -f $GalleryName, $GalleryUser } else { $targetName = 'IBH {0} Token ({1})' -f $GalleryName, $ModuleName } $GalleryToken = Use-VaultSecureString -TargetName $targetName } try { $token = $GalleryToken | Unprotect-SecureString Publish-Module -Path "$BuildRoot\$ModuleName" -Repository $GalleryName -NuGetApiKey $token -ReleaseNotes $releaseNotes } finally { Remove-Variable -Name 'token' -Force } } |