如何用PowerShell 5系统类向已有PowerShell生成的ZIP添加文件夹

看起来你已经尝试写了一个函数，但代码里有几个明显的问题（比如尝试访问字符串参数的.Name属性，还有代码没写完）。下面我会用PowerShell 5原生支持的.NET类，给你一个完整的解决方案，完全不需要第三方工具。

核心思路 #

我们要用到.NET的System.IO.Compression.ZipArchive和相关类，通过更新模式打开现有ZIP文件，然后递归遍历要添加的文件夹，把里面的所有文件和子文件夹都添加到ZIP中，同时保持原有的目录结构。

完整实现代码 #

function Add-FolderToZip {
    param(
        [Parameter(Mandatory=$true)]
        [string]$FolderPathToAdd,
        [Parameter(Mandatory=$true)]
        [string]$ArchivePathToUpdate
    )

    # 确保加载必要的.NET程序集（PowerShell 5通常已加载，但显式加载更可靠）
    Add-Type -AssemblyName System.IO.Compression.FileSystem

    # 验证输入路径是否存在
    if (-not (Test-Path -Path $FolderPathToAdd -PathType Container)) {
        Write-Error "要添加的文件夹不存在：$FolderPathToAdd"
        return
    }
    if (-not (Test-Path -Path $ArchivePathToUpdate -PathType Leaf)) {
        Write-Error "目标ZIP文件不存在：$ArchivePathToUpdate"
        return
    }

    try {
        # 以更新模式打开ZIP文件
        $zipArchive = [System.IO.Compression.ZipFile]::Open($ArchivePathToUpdate, [System.IO.Compression.ZipArchiveMode]::Update)
        
        # 获取要添加的文件夹的父路径，用于计算ZIP内的相对路径
        $folderRoot = (Get-Item -Path $FolderPathToAdd).FullName

        # 递归遍历文件夹中的所有项目
        Get-ChildItem -Path $FolderPathToAdd -Recurse | ForEach-Object {
            # 计算当前项目在ZIP中的相对路径（ZIP要求用正斜杠）
            $relativePath = $_.FullName.Substring($folderRoot.Length).Replace('\', '/')
            # 如果是文件夹，创建对应的空目录条目（ZIP需要显式的目录条目来保留结构）
            if ($_.PSIsContainer) {
                $zipArchive.CreateEntry($relativePath + '/')
            }
            # 如果是文件，创建文件条目并写入内容
            else {
                $entry = $zipArchive.CreateEntry($relativePath)
                using ($fileStream = $_.OpenRead())
                using ($entryStream = $entry.Open()) {
                    $fileStream.CopyTo($entryStream)
                }
            }
        }

        Write-Host "成功将文件夹 $FolderPathToAdd 添加到ZIP文件 $ArchivePathToUpdate"
    }
    catch {
        Write-Error "添加过程中发生错误：$_"
    }
    finally {
        # 确保ZIP归档被正确关闭
        if ($zipArchive) {
            $zipArchive.Dispose()
        }
    }
}

代码解释 #

• 程序集加载：显式加载System.IO.Compression.FileSystem，确保我们能使用ZipFile和ZipArchive类。
• 路径验证：先检查要添加的文件夹和目标ZIP是否存在，避免后续错误。
• ZIP打开模式：使用Update模式，允许我们在现有ZIP中添加新内容。
• 递归遍历：用Get-ChildItem -Recurse遍历文件夹下的所有文件和子文件夹，保证完整的目录结构被保留。
• 相对路径处理：将Windows风格的反斜杠替换为ZIP标准的正斜杠，确保目录结构在ZIP中正确显示。
• 资源释放：使用using语句和finally块确保文件流和ZIP归档被正确关闭，避免文件占用问题。

示例用法 #

# 把C:\MyFolder添加到D:\ExistingArchive.zip中
Add-FolderToZip -FolderPathToAdd "C:\MyFolder" -ArchivePathToUpdate "D:\ExistingArchive.zip"

注意事项 #

• 确保目标ZIP文件没有被其他进程占用（比如正在被解压或打开），否则会报错。
• 如果你只需要添加单个文件，只需要修改函数中的遍历逻辑，直接处理单个文件即可。
• PowerShell 5的.NET类对ZIP的支持是基础的，不支持加密等高级功能，但完全满足普通的添加需求。

内容的提问来源于stack exchange，提问作者Alloue