Архивы

Извлечь файлы из zip по маске

Достаёт из zip только элементы, подходящие под шаблон, с проверкой путей и перезаписи.

PowerShell Windows Средний
Скачать Extract-ZipByMask.ps1
Описание

Что делает скрипт

Скрипт ищет совпадения по полному имени и по имени файла, поэтому маска *.log работает на любой глубине. Пути проверяются до создания каталогов, а ключ -Flatten складывает результаты в одну папку. Без -Force существующие файлы не перезаписываются.

Перед запуском
  • Существующие файлы перезаписываются только с ключом -Force.
Запуск

Быстрый старт

powershell -File Extract-ZipByMask.ps1 -ArchivePath .\logs.zip -Pattern '*.log' -DestinationPath .\logs

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. Запускайте в PowerShell 5.1 или PowerShell 7.

Примеры

Другие варианты

  • powershell -File Extract-ZipByMask.ps1 -ArchivePath .\logs.zip -Pattern '*.log' -DestinationPath .\logs
  • powershell -File Extract-ZipByMask.ps1 -ArchivePath .\backup.zip -Pattern 'docs/*.txt' -DestinationPath .\docs
  • powershell -File Extract-ZipByMask.ps1 -ArchivePath .\backup.zip -Pattern '*.csv' -DestinationPath .\csv -Flatten -Force
Зависимости

Что понадобится

PowerShell 5.1+ Windows PowerShell или PowerShell 7
Windows Встроен в Windows 10/11 (PowerShell 5.1)
Исходник

Extract-ZipByMask.ps1

[CmdletBinding()]
param(
    [Parameter(Mandatory = $true)]
    [string]$ArchivePath,
    [Parameter(Mandatory = $true)]
    [string]$Pattern,
    [Parameter(Mandatory = $true)]
    [string]$DestinationPath,
    [switch]$Flatten,
    [switch]$Force
)

$ErrorActionPreference = 'Stop'
Add-Type -AssemblyName System.IO.Compression.FileSystem

if (-not (Test-Path -LiteralPath $ArchivePath -PathType Leaf)) {
    throw "Архив не найден: $ArchivePath"
}
$archiveFull = (Resolve-Path -LiteralPath $ArchivePath).Path
$destFull = [IO.Path]::GetFullPath($DestinationPath)
if (Test-Path -LiteralPath $destFull -PathType Leaf) {
    throw "Цель является файлом: $destFull"
}
if (-not (Test-Path -LiteralPath $destFull)) {
    New-Item -ItemType Directory -Path $destFull -Force | Out-Null
}
$prefix = $destFull
if (-not $prefix.EndsWith([string][IO.Path]::DirectorySeparatorChar)) {
    $prefix += [IO.Path]::DirectorySeparatorChar
}

$zip = [IO.Compression.ZipFile]::OpenRead($archiveFull)
try {
    $plan = New-Object System.Collections.ArrayList
    $seen = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
    foreach ($entry in $zip.Entries) {
        $name = $entry.FullName.Replace('\', '/')
        if ([string]::IsNullOrWhiteSpace($name) -or $name.EndsWith('/')) { continue }
        if (-not ($name -like $Pattern -or $entry.Name -like $Pattern)) { continue }
        if ($name.StartsWith('/') -or $name -match '^[A-Za-z]:' -or $name.Contains(':') -or $name -match '(^|/)\.\.(/|$)') {
            throw "Небезопасный путь: $($entry.FullName)"
        }
        $relative = if ($Flatten) { $entry.Name } else { $name }
        $target = [IO.Path]::GetFullPath((Join-Path $destFull $relative))
        if (-not $target.StartsWith($prefix, [StringComparison]::OrdinalIgnoreCase)) {
            throw "Путь вне папки: $($entry.FullName)"
        }
        if (-not $seen.Add($target)) {
            throw "После уплощения имена совпадают: $relative"
        }
        if ((Test-Path -LiteralPath $target) -and -not $Force) {
            throw "Файл уже существует: $target"
        }
        [void]$plan.Add([pscustomobject]@{ Entry = $entry; Target = $target })
    }
    if ($plan.Count -eq 0) {
        throw "Под маску $Pattern ничего не подошло"
    }
    foreach ($item in $plan) {
        $parent = Split-Path -Parent $item.Target
        if (-not (Test-Path -LiteralPath $parent)) {
            New-Item -ItemType Directory -Path $parent -Force | Out-Null
        }
        [IO.Compression.ZipFileExtensions]::ExtractToFile($item.Entry, $item.Target, [bool]$Force)
    }
    "Извлечено файлов: $($plan.Count) в $destFull"
} finally {
    $zip.Dispose()
}

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get archives-extract-by-mask
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Архивы

Упаковка, распаковка, проверка целостности и безопасная работа с архивами.