GetPlasterTemplate.ps1
|
. $PSScriptRoot\GetModuleExtension.ps1 function Get-PlasterTemplate { [CmdletBinding()] param( [Parameter(Position = 0, ParameterSetName = "Path", HelpMessage = "Specifies a path to a folder containing a Plaster template or multiple template folders. Can also be a path to plasterManifest.xml.")] [ValidateNotNullOrEmpty()] [string] $Path, [Parameter(Position = 1, ParameterSetName = "Path", HelpMessage = "Will return templates that match the name.")] [Parameter(Position = 1, ParameterSetName = "IncludedTemplates", HelpMessage = "Will return templates that match the name.")] [ValidateNotNullOrEmpty()] [string] $Name = "*", [Parameter(ParameterSetName = "Path", HelpMessage = "Will return templates that match the tag.")] [Parameter(ParameterSetName = "IncludedTemplates", HelpMessage = "Will return templates that match the tag.")] [ValidateNotNullOrEmpty()] [string] $Tag = "*", [Parameter(ParameterSetName = "Path", HelpMessage = "Indicates that this cmdlet gets the items in the specified locations and in all child items of the locations.")] [switch] $Recurse, [Parameter(Position = 0, Mandatory = $true, ParameterSetName = "IncludedTemplates", HelpMessage = "Initiates a search for latest version Plaster templates inside of installed modules.")] [switch] [Alias("IncludeModules")] $IncludeInstalledModules, [Parameter(ParameterSetName = "IncludedTemplates", HelpMessage = "If specified, searches for Plaster templates inside of all installed module versions.")] [switch] $ListAvailable ) process { function CreateTemplateObjectFromManifest([System.IO.FileInfo]$manifestPath, [string]$name, [string]$tag) { $manifestXml = Test-PlasterManifest -Path $manifestPath $metadata = $manifestXml["plasterManifest"]["metadata"] $manifestObj = [PSCustomObject]@{ Name = $metadata["name"].InnerText Title = $metadata["title"].InnerText Author = $metadata["author"].InnerText Version = New-Object -TypeName "System.Version" -ArgumentList $metadata["version"].InnerText Description = $metadata["description"].InnerText Tags = $metadata["tags"].InnerText.split(",") | ForEach-Object { $_.Trim() } TemplatePath = $manifestPath.Directory.FullName } $manifestObj.PSTypeNames.Insert(0, "Microsoft.PowerShell.Plaster.PlasterTemplate") Add-Member -MemberType ScriptMethod -InputObject $manifestObj -Name "InvokePlaster" -Value { Invoke-Plaster -TemplatePath $this.TemplatePath } return $manifestObj | Where-Object Name -like $name | Where-Object Tags -like $tag } function GetManifestsUnderPath([string]$rootPath, [bool]$recurse, [string]$name, [string]$tag) { $manifestPaths = Get-ChildItem -Path $rootPath -Include "plasterManifest.xml" -Recurse:$recurse foreach ($manifestPath in $manifestPaths) { CreateTemplateObjectFromManifest $manifestPath $name $tag -ErrorAction SilentlyContinue } } if ($Path) { # Is this a folder path or a Plaster manifest file path? if (!$Recurse.IsPresent) { if (Test-Path $Path -PathType Container) { $Path = Resolve-Path "$Path/plasterManifest.xml" } # Use Test-PlasterManifest to load the manifest file Write-Verbose "Attempting to get Plaster template at path: $Path" CreateTemplateObjectFromManifest $Path $Name $Tag } else { Write-Verbose "Attempting to get Plaster templates recursively under path: $Path" GetManifestsUnderPath $Path $Recurse.IsPresent $Name $Tag } } else { # Return all templates included with Plaster GetManifestsUnderPath "$PSScriptRoot\Templates" $true $Name $Tag if ($IncludeInstalledModules.IsPresent) { # Search for templates in module path $GetModuleExtensionParams = @{ ModuleName = "Plaster" ModuleVersion = $PlasterVersion ListAvailable = $ListAvailable } $extensions = Get-ModuleExtension @GetModuleExtensionParams foreach ($extension in $extensions) { # Scan all module paths registered in the module foreach ($templatePath in $extension.Details.TemplatePaths) { $expandedTemplatePath = [System.IO.Path]::Combine( $extension.Module.ModuleBase, $templatePath, "plasterManifest.xml") CreateTemplateObjectFromManifest $expandedTemplatePath $Name $Tag -ErrorAction SilentlyContinue } } } } } } |