PowerShell Copy-Item| PowerShell复制文件

本文概述

• 句法
• 参数
• 例子

Copy-Item cmdlet将项目从一个位置复制到名称空间中的另一个位置。例如, 此cmdlet可以将文件复制到文件夹, 但是不能将文件复制到证书驱动器。它不会删除或剪切要复制的项目。 cmdlet复制的那些特定项目取决于PowerShell提供程序, 该提供程序公开了该项目。

例如, 此cmdlet可以复制文件系统驱动器中的文件和目录以及注册表驱动器中的注册表项和条目。它可以复制和重命名同一cmdlet中的项目。在-Destination参数的值中输入新名称以重命名项目。

句法

Copy-Item
[-Confirm]
[-Path <String[]>] 
[-Destination <String>] 
[-Filter <String>]
[-Force]
[-Container]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse] 
[-PassThru]
[-Credential <PSCredential>] 
[-WhatIf] 
[-FromSession<PSSession>] 
[-ToSession<PSSession>]
[<CommonParameters>]

Copy-Item
[-Confirm]
[-LiteralPath<String[]>]
[-Destination <String>]
[-Filter <String>]
[-Force]
[-Container]
[-Include <String[]>] 
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>] 
[-WhatIf]
[-FromSession<PSSession>]
[-ToSession<PSSession>]
[<CommonParameters>]

参数

-确认

-Confirm参数在运行cmdlet之前提示确认。

-路径

-Path参数中的字符串数组用于指定要复制的项目的路径。接受通配符。

文学路径

-LiteralPath参数用于指定位置的路径。它的值与键入时完全一样。如果路径包含转义符, 则将其用单引号引起来。单引号告诉Windows PowerShell, 它不应将任何字符解释为转义序列。 cmdlet中没有字符, 该字符被解释为通配符。

-目的地

-Destination参数用于指定新位置的路径。默认为当前位置。不接受通配符。要重命名要复制的项目, 请在-Destination参数的值中为其赋予一个新名称。

-过滤

-Filter参数指定用于限定-Path参数的过滤器。 FileSystem提供程序是唯一支持使用过滤器的PowerShell提供程序。此参数效率更高, 因为提供程序在cmdlet获取对象时应用筛选器, 而不是让Powershell在访问对象后筛选对象。

-力

此参数指示此cmdlet复制那些不能更改的项目, 例如, 复制只读文件或别名。

-容器

-Container参数指示此cmdlet在复制操作期间保留容器对象。默认情况下, 此参数设置为True。

-包括

此cmdlet包括在操作中的项目被指定为字符串数组。 -Include参数的值限定-Path参数。输入模式或路径元素, 例如* .txt。接受通配符。仅当cmdlet包含项目的内容(例如C：\ *, 通配符’*’用于指定C：目录的内容)时, -Exclude参数才有效。

-排除

此cmdlet在操作中排除的项目指定为字符串数组。 -Exclude参数的值限定-Path参数。输入模式或路径元素, 例如* .txt。接受通配符。仅当cmdlet包含项目的内容(例如C：\ *, 通配符’*’用于指定C：目录的内容)时, -Exclude参数才有效。

-递归

-Recurse参数指示此cmdlet执行递归副本。

直通

-PassThru参数返回一个对象, 该对象表示我们正在使用的项目。是默认值；它不会产生任何输出。

-凭据

与PowerShell一起安装的任何提供程序均不支持-Credential参数。默认情况下, 此参数使用当前用户。

-如果

-WhatIf参数显示如果执行cmdlet将发生的情况。该cmdlet不执行。

-FromSession

-FromSession参数用于指定从中复制远程文件的PSSession对象。使用它时, -path和-LiteralPath参数都引用远程计算机上的本地路径。

到会话

-ToSession参数用于指定要将远程文件复制到的PSSession对象。当我们使用它时, -Destination参数引用远程计算机上的本地路径。

例子

示例1：将文件复制到指定位置

此示例中的cmdlet将powershell.txt文件复制到D：\ windows目录。原始文件不会被删除。

示例2：将目录的内容复制到新目录

此示例中的cmdlet复制C：\ srcmini源目录的内容并创建一个新的目标目录。新的目标目录\ files在D：\驱动器中创建。

示例3：将目录的内容复制到现有目录

此示例中的cmdlet将C：\ srcmini目录的内容复制到现有目录C：\ PowerShell目录中。未复制srcmini目录。

如果srcmini目录在子目录中包含文件, 则也将复制它们的文件树并保持原样。默认情况下,

-Container参数设置为True, 这将保留目录的结构。

示例4：将文件复制到给定目录并重命名该文件

此示例中的cmdlet将文件s.txt从D：\目录复制到D：\ jtp目录, 并将文件名从s.txt更改为s1.txt。