如何使用 Copy-Item 在 PowerShell 中复制文件

---

我们可以使用 PowerShell 通过 Copy-Item cmdlet 将文件从一个位置复制到另一个位置。该位置可以是另一个本地文件夹或远程计算机。除了文件之外，我们还可以复制包含子文件夹和内容的完整文件夹。甚至可以过滤我们复制的文件。

在本文中，我们将了解如何使用 PowerShell 复制文件的不同示例。

使用 PowerShell 复制文件

让我们从使用 PowerShell 复制文件的基础知识开始。当您想要复制单个文件时，您需要指定源路径和目标文件夹：

Copy-Item -Path "C:\temp\files\la-ams-ad01-log-1.txt" -Destination "d:\temp\"

# Copy is a shorthand for Copy-Item:
Copy "C:\temp\files\la-ams-ad01-log-1.txt" "d:\temp\"

请记住，您需要以\结尾目标文件夹名称，否则，您将重命名该文件。这也是 Copy-Item cmdlet 的有用功能之一，我们可以为目标上的文件指定一个新名称：

# Copy and rename the file:
Copy-Item -Path "C:\temp\files\la-ams-ad01-log-2.txt" -Destination "d:\temp\logfile.txt"

复制多个文件

要使用 PowerShell 复制多个文件，您可以使用筛选器（我将在本文后面解释），或者选择路径中的多个文件。为此，您需要用逗号分隔每个文件。对于目的地，您将需要使用文件夹。

# Copy ad01-log-1.txt and ad01-log-2.txt
Copy-Item -Path C:\temp\files\ad01-log-1.txt,C:\temp\files\ad01-log-2.txt -Destination d:\temp\

PowerShell 复制文件夹

我们还可以使用 Copy-Item cmdlet 将完整文件夹复制到新位置。但是，在复制文件夹时，在源路径和目标路径中使用正确的结尾非常重要：

SourceDestination Resultsc:\tempd:\tempCreates only the folder tempc:\temp\d:\temp\Creates only the folder tempc:\temp\*d:\tempCreate folder temp and copy only the files from c:\temp c:\temp\d:\temp -RecurseCopies folder inc subfolders and all content

在下面的示例中，我将使用以下文件夹结构，并以子文件夹作为源：

C:\TEMP\FILES
│   11022022-app.log
│   11032021-app.log
│   11032022-app.log
│   11102021-app.log
│   15032022-app.log
│   la-ams-ad01-log-1.txt
│   la-ams-ad01-log-2.txt
│   la-ams-ad01-log-3.txt
│   la-ams-ad01-log-4.txt
│   la-ams-file02-log-1.txt
│   la-ams-file02-log-2.txt
│
└───subfolder
        la-osl-ad01-log-1.txt
        la-osl-file01-log-1.txt
        LT3452-process-errors.log
        LT3452-process.log
        readme.txt

要仅复制 c:\temp\files 中的文件和空子文件夹，我们需要对源路径使用通配符：

Copy-Item -Path "C:\temp\files\*"  -Destination "d:\temp\"

# Result
D:\TEMP
│   11022022-app.log
│   11032021-app.log
│   11032022-app.log
│   11102021-app.log
│   15032022-app.log
│   la-ams-ad01-log-1.txt
│   la-ams-ad01-log-2.txt
│   la-ams-ad01-log-3.txt
│   la-ams-ad01-log-4.txt
│   la-ams-file02-log-1.txt
│   la-ams-file02-log-2.txt
│
└───subfolder  # Note - Sub folder is empty

要使用 PowerShell 复制包括子文件夹在内的所有内容，我们需要指定 -recurce 参数。这样子文件夹的内容也会复制到新位置：

# Copy all content including subfolder:
Copy-Item -Path "C:\temp\files\*"  -Destination "d:\temp\" -Recurse

# Result
D:\TEMP
│   11022022-app.log
│   11032021-app.log
│   11032022-app.log
│   11102021-app.log
│   15032022-app.log
│   la-ams-ad01-log-1.txt
│   la-ams-ad01-log-2.txt
│   la-ams-ad01-log-3.txt
│   la-ams-ad01-log-4.txt
│   la-ams-file02-log-1.txt
│   la-ams-file02-log-2.txt
│
└───subfolder
        la-osl-ad01-log-1.txt
        la-osl-file01-log-1.txt
        LT3452-process-errors.log
        LT3452-process.log
        readme.txt

一次复制并合并多个文件夹

您可能不会经常使用但非常方便的功能是使用 Copy-Item cmdlet 一次复制和合并多个文件夹。我们可以指定 cmdlet 的多个源路径和一个目标。

这样，所有源位置的内容将被复制到一个位置：

 Copy-Item -Path c:\logs-server-A\*,c:\logs-server-b\* -Destination d:\logs

过滤要复制的文件

使用 Include 和 Exclude 参数，我们可以过滤出要复制或不复制的文件。该过滤器与文件的全名（包括扩展名）以及源路径中的文件夹名称进行匹配。

因此，要仅复制扩展名为 .log 的文件，我们可以使用包含过滤器，如下所示：

# Copy only files with the extension .log
Copy-Item -Path c:\temp\* -Destination d:\temp -Include *.log

# Result
# Note that the .log files from the subfolder are note copied
D:\TEMP
    11022022-app.log
    11032021-app.log
    11032022-app.log
    11102021-app.log
    15032022-app.log

请注意通配符，如果您想过滤名称的一部分，则始终需要通配符。值得高兴的是，-Recurse 参数在这里不起作用。如果您的子文件夹中包含 .log 文件，则不会复制它们。过滤器仅应用于路径的顶层。

使用排除过滤器

排除文件的工作方式相同。我们可以指定不想复制的文件和文件夹的部分名称。请记住，如果子文件夹与排除字符串不匹配，则该子文件夹及其所有内容也将被复制。

# Copy everything, except .log files:
Copy-Item -Path c:\temp\files\* -Destination d:\temp\ -Exclude *.log -Recurse

# Result:
D:\TEMP
│   la-ams-ad01-log-1.txt
│   la-ams-ad01-log-2.txt
│   la-ams-ad01-log-3.txt
│   la-ams-ad01-log-4.txt
│   la-ams-file02-log-1.txt
│   la-ams-file02-log-2.txt
│
└───subfolder
        la-osl-ad01-log-1.txt
        la-osl-file01-log-1.txt
        readme.txt

使用 PowerShell 将文件复制到远程计算机

还可以使用 PowerShell 将文件复制到远程计算机或从远程计算机复制文件。有两种方法可以执行此操作，您可以使用 New-PSDrive cmdlet 创建临时网络驱动器。或者首先创建到远程计算机的新 PowerShell 会话。

为此，您需要有权访问远程计算机，或使用远程计算机的凭据来启动 PSSession：

$Session = New-PSSession -ComputerName "LazyServer01" -Credential "LazyAdmin\User01"

创建会话并将其存储在 $session 变量中后，我们可以将项目复制到远程计算机上的任何位置。在这种情况下，目标路径是远程计算机上的本地路径，因此要将文件复制到远程计算机上的 temp 文件夹，只需使用 c:\temp 作为目标路径：

# Copy all files from the local temp folder to the temp folder on the remote computer
Copy-Item -Path c:\temp\local\* -Destination c:\temp\remote\ -ToSession $Session -Recurse

您可以使用相同的方法通过 PowerShell 将文件从远程计算机复制到本地计算机。在这种情况下，我们只需要使用-FromSession参数而不是-ToSession。

$Session = New-PSSession -ComputerName "LazyServer01" -Credential "LazyAdmin\User01"
Copy-Item -Path c:\temp\remote* -Destination c:\temp\local\ -FromSession $Session -Recurse

总结

在复制本地或远程计算机上的文件时，PowerShell Copy-Item cmdlet 非常有用。您无法将它与强大的 robocopy 命令进行比较，但尽管如此，它仍然是一个有用的 cmdlet。

我希望本文能帮助您使用 PowerShell 复制文件或文件夹。如果您有任何疑问，请在下面发表评论。