functions/Get-DBOPackage.ps1
|
Function Get-DBOPackage { <# .SYNOPSIS Shows information about the existin DBOps package .DESCRIPTION Reads DBOps package header and configuration files and returns an object with corresponding properties. .PARAMETER Path Path to the DBOps package Aliases: Name, FileName, Package .PARAMETER InputObject Pipeline implementation of Path. Can also accept a DBOpsPackage object. .PARAMETER Unpacked Mostly intended for internal use. Gets package information from extracted package. .PARAMETER Confirm Prompts to confirm certain actions .PARAMETER WhatIf Shows what would happen if the command would execute, but does not actually perform the command .EXAMPLE # Returns information about the package myPackage.zip, only including infomartion about builds 1.1 and 1.2 Get-DBOPackage -Path c:\temp\myPackage.zip -Build 1.1, 1.2 .NOTES #> [CmdletBinding(DefaultParameterSetName = 'Default')] Param( [Parameter(Mandatory = $false, ParameterSetName = 'Default', Position = 1)] [Alias('FileName', 'Name', 'Package')] [string[]]$Path, [Parameter(Mandatory = $false, ValueFromPipeline = $true, ParameterSetName = 'Pipeline')] [object]$InputObject, [switch]$Unpacked ) begin { } process { if ($PsCmdlet.ParameterSetName -eq 'Pipeline') { if ($InputObject) { if ($InputObject -is [DBOpsPackageBase]) { Write-Verbose "Loading package file from pipelined object" $InputObject } elseif ($InputObject -is [System.IO.FileInfo]) { Write-Verbose "Loading package file from the archive $($InputObject.FullName)" [DBOpsPackage]::new($InputObject.FullName) } elseif ($InputObject -is [String]) { Write-Verbose "Loading package file from the archive $($InputObject)" [DBOpsPackage]::new($InputObject) } else { throw "The following object type is not supported: $($InputObject.GetType().Name). The only supported types are DBOpsPackage, FileInfo and String" } } else { throw "The object was not found" } } elseif ($PsCmdlet.ParameterSetName -eq 'Default') { foreach ($pathItem in (Get-Item $Path -ErrorAction Stop)) { if ($Unpacked) { if ($pathItem.PSIsContainer) { $packageFileName = [DBOpsConfig]::GetPackageFileName() $packageFile = Join-Path $pathItem.FullName $packageFileName Write-Verbose "Loading package $packageFileName from folder $($pathItem.FullName)" [DBOpsPackageFile]::new($packageFile) } else { Write-Verbose "Loading package from the json file $pathItem" [DBOpsPackageFile]::new($pathItem.FullName) } } else { Write-Verbose "Loading package file from the archive $pathItem" [DBOpsPackage]::new($pathItem.FullName) } } } else { Write-Verbose "Creating new DBOps package $pFile" [DBOpsPackage]::new() } } end { } } |