functions/build/Publish-PSMDBuildArtifact.ps1
|
function Publish-PSMDBuildArtifact { <# .SYNOPSIS Create a new artifact for the current build pipeline. .DESCRIPTION Create a new artifact for the current build pipeline. Use this create artifacts that are accessible in later steps in the pipeline. Usually, artifacts are deleted at the end of a build process. They are always cleared at the beginning of a new one. Artifacts are NOT persisted across PowerShell sessions. .PARAMETER Name Name of the Artifact to create. Technically there are no limits to which character to chose, but we strongly encourage restricting yourself to letters, numbers, dash, underscore and dot. .PARAMETER Value The value to assign to the artifact. .PARAMETER Tag Any tags to add to an artifact. Tags can be searched for in order to bulk-operate against all artifacts of that tag. For example, the "remove-pssession" action can remove all remoting sessions for all artifacts tagged as "pssession". .EXAMPLE PS C:\> Publish-PSMDBuildArtifact -Name 'session' -Value $session -Tag 'pssession' Publishes an artifact named "session" containing the content of $session that is tagged as a PowerShell remoting session. #> [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $Name, [Parameter(Mandatory = $true)] [AllowNull()] $Value, [string[]] $Tag = @() ) process { $script:buildArtifacts[$Name] = [pscustomobject]@{ PSTypeName = 'PSModuleDevelopment.Build.Artifact' Name = $Name Value = $Value Tags = $Tag } } } |