Public/New-7zArchive.ps1
|
function New-7zArchive() { <# .SYNOPSIS Create a new 7-Zip archive .DESCRIPTION Use this cmdlet to create 7-Zip archives. Possible types are 7z (default) as well as zip, gzip, bzip2, tar, iso, udf archive formats. This needs testing...made usable The archive file is overwritten if it exists and the -force parameter is used .EXAMPLE New-7zArchive new-archive *.txt Creates a new 7-zip-archive named 'new-archive.7z' containing all files with a .txt extension in the current directory .EXAMPLE New-7zArchive new-archive *.txt -ArchiveType zip Creates a new zip-archive named 'new-archive.zip' containing all files with a .txt extension in the current directory .EXAMPLE New-7zArchive new-archive *.jpg,*.gif,*.png,*.bmp -Recurse -Exclude tmp/ Creates a new 7-zip archive named 'new-archive.7z' containing all files with an extension of jpg, gif, png or bmp in the current directory and all directories below it All files in the folder tmp are excluded, i.e. not included in the archive. #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact='Low')] [OutputType([string[]])] Param( # The path of the archive to create [Parameter(Mandatory, Position=0)] [string] $ArchivePath, # A list of file names or patterns to include [Parameter(Mandatory=$true, Position=1)] [string[]] $FilesToInclude, # A list of file names or patterns to exclude [Parameter(Mandatory=$false)] [AllowEmptyCollection()] [string[]] $FilesToExclude, # The type of archive to create [ValidateSet('7z','zip','gzip','bzip2','tar','iso','udf')] [string] $ArchiveType = '7z', #If specified apply password to archive and encrypt headers [SecureString] $Password, # Additional switches for 7zip (Feature intended for advanced usage) [string]$Switches, # Apply include patterns recursively [switch]$Recurse, [switch] $Force ) if ($PSCmdlet.ShouldProcess("Create Archive")) { if (Test-Path -Path $ArchivePath) { if (-Not $Force.IsPresent ) { $Message = ('{0} archive `"{1}`" failed: File already exists!{2}Use -Force to overwrite archive.' -f $verb, $ArchivePath, "`r`n") Debug-ThrowException ` -Message $Message ` -Verb 'New' ` -Path $ArchivePath ` -Output $Message ` -LineNumber (Get-CurrentLineNumber) ` -Filename (Get-CurrentFileName) ` -Executable $7zSettings.Path7zEXE } Write-Debug -Message ('Deleting file: {0}' -f $ArchivePath ) try { Remove-Item -Path $ArchivePath -Force -ErrorAction Stop } catch { Debug-ThrowException ` -Message $_.Exception.Message ` -Verb 'New' ` -Path $ArchivePath ` -Output $_.Exception.Message ` -LineNumber Get-CurrentLineNumber ` -Filename Get-CurrentFileName ` -Executable $7zSettings.Path7zEXE ` -Exception $_.Exception } } [hashtable]$params = @{ Operation = 'New' ArchiveType = $ArchiveType ArchivePath = $ArchivePath Include = $FilesToInclude Exclude = $FilesToExclude Switches = $Switches } if ( $PSBoundParameters.ContainsKey('Password') ) { # Password parameter present $params.Add('Password',$Password) } if ( $PSBoundParameters.ContainsKey('Force') ) { # Force parameter present $params.Add('Force',$true) } if ( $PSBoundParameters.ContainsKey('Recurse') ) { # Recurse parameter present $params.Add('Recurse',$true) } $params.GetEnumerator() | ForEach-Object { Write-Debug -Message ('{0}: {1}' -f ($_.Key), ($_.Value) ) } [string[]]$result = Invoke-7zInterop @params return $result } } |