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]
    [-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]
    [-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]
    [<CommonParameters>]

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

Description

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

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

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

예제

예제 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 원본 디렉터리의 내용을 복사하고 새 대상 디렉터리를 만드는 예제입니다. 새 대상 디렉터리 \LogsC:\Drawings만들어집니다.

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

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

메모

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

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

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

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

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