Copy-Item

참조

모듈:: Microsoft.PowerShell.Management

위치 간에 항목을 복사합니다.

구문

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

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

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

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

Description

cmdlet은 Copy-Item 한 위치에서 동일한 네임스페이스의 다른 위치로 항목을 복사합니다. 예를 들어 파일을 폴더에 복사할 수 있지만 인증서 드라이브에 파일을 복사할 수는 없습니다.

이 cmdlet은 복사되는 항목을 잘라내거나 삭제하지 않습니다. cmdlet에서 복사할 수 있는 특정 항목은 항목을 노출하는 PowerShell 공급자에 따라 달라집니다. 예를 들어 파일 시스템 드라이브의 파일 및 디렉터리와 레지스트리 드라이브의 레지스트리 키 및 항목을 복사할 수 있습니다.

이 cmdlet은 동일한 명령에서 항목을 복사하고 이름을 바꿀 수 있습니다. 항목의 이름을 바꾸려면 Destination 매개 변수 값에 새 이름을 입력합니다. 항목의 이름을 바꾸고 복사하지 않려면 cmdlet을 Rename-Item 사용합니다.

예제

예제 1: 지정된 디렉터리에 파일 복사

이 예제에서는 mar1604.log.txt 파일을 C:\Presentation 디렉터리에 복사합니다. 원본 파일은 삭제되지 않습니다.

Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"

예제 2: 디렉터리 내용을 기존 디렉터리에 복사

다음은 디렉터리의 내용을 C:\Logfiles 기존 디렉터리에 복사하는 C:\Drawings 예제입니다. Logfiles 디렉터리가 복사되지 않습니다.

Logfiles 디렉터리에 하위 디렉터리에 파일이 있는 경우 해당 하위 디렉터리는 파일 트리를 그대로 사용하여 복사됩니다. 기본적으로 Container 매개 변수는 디렉터리 구조를 유지하는 True로 설정됩니다.

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse

참고 항목

경로 C:\Drawings 가 없으면 cmdlet은 폴더 트리의 모든 파일을 Logfiles 단일 폴더 C:\Drawings로 복사하여 동일한 이름의 파일을 덮어씁니다.

예제 3: 디렉터리 및 내용을 새 디렉터리에 복사

다음은 원본 디렉터리의 내용을 C:\Logfiles 복사하고 새 대상 디렉터리를 만드는 예제입니다. 에 새 대상 디렉터리가 \Logs 만들어집니다 C:\Drawings.

원본 디렉터리의 이름을 포함하려면 예제 2와 같이 기존 대상 디렉터리에 복사합니다. 또는 새 대상 디렉터리의 이름을 원본 디렉터리와 동일하게 지정합니다.

Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -Recurse

참고 항목

경로에 포함된 \*경우 하위 디렉터리 트리를 포함한 모든 디렉터리의 파일 내용이 새 대상 디렉터리에 복사됩니다. 예시:

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse

예제 4: 지정된 디렉터리에 파일 복사 및 파일 이름 바꾸기

이 예제에서는 cmdlet을 Copy-Item 사용하여 디렉터리에서 \\Server01\Share 디렉터리로 스크립트를 \\Server12\ScriptArchive 복사 Get-Widget.ps1 합니다. 복사 작업의 일부로 명령은 항목 이름을 전자 Get-Widget.ps1 Get-Widget.ps1.txt메일 메시지에 안전하게 첨부할 수 있도록 항목 이름을 변경합니다.

Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"