Move-Item

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Move-Item cmdlet은 속성, 콘텐츠 및 자식 항목을 포함한 항목을 한 위치에서 다른 위치로 이동합니다. 위치는 동일한 공급자가 지원해야 합니다.

예를 들어 파일 또는 하위 디렉터리를 한 디렉터리에서 다른 디렉터리로 이동하거나 레지스트리 하위 키를 한 키에서 다른 키로 이동할 수 있습니다. 항목을 이동하면 새 위치에 추가되고 원래 위치에서 삭제됩니다.

이 명령은 Test.txt 파일을 C: 드라이브에서 E:\Temp 디렉터리로 이동하고 이름을 test.txt 이름을 tst.txt.

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

이 명령은 C:\Temp 디렉터리와 해당 내용을 C:\Logs 디렉터리로 이동합니다. Temp 디렉터리와 모든 하위 디렉터리 및 파일이 Logs 디렉터리에 나타납니다.

Move-Item -Path C:\Temp -Destination C:\Logs

이 명령은 현재 디렉터리(점(*.txt)로 표시됨)의 모든 텍스트 파일(.)을 C:\Logs 디렉터리로 이동합니다.

Move-Item -Path .\*.txt -Destination C:\Logs

이 명령은 모든 텍스트 파일을 현재 디렉터리와 모든 하위 디렉터리에서 재귀적으로 C:\TextFiles 디렉터리로 이동합니다.

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

이 명령은 Get-ChildItem cmdlet을 사용하여 현재 디렉터리(점(.)로 표시됨)의 모든 자식 항목과 *.txt 파일 이름 확장명이 있는 하위 디렉터리를 가져옵니다. Recurse 매개 변수를 사용하여 검색 재귀를 만들고 Include 매개 변수를 사용하여 검색을 *.txt 파일로 제한합니다.

파이프라인 연산자(|)는 텍스트 파일을 Move-Item 디렉터리로 이동하는 이 명령의 결과를 TextFiles보냅니다.

C:\Textfiles 이동할 파일의 이름이 같으면 Move-Item 오류를 표시하고 계속하지만 각 이름의 파일 하나만 C:\Textfiles이동합니다. 다른 파일은 원래 디렉터리에 남아 있습니다.

Textfiles 디렉터리(또는 대상 경로의 다른 요소)가 없으면 명령이 실패합니다. Force 매개 변수를 사용하는 경우에도 누락된 디렉터리가 만들어지지 않습니다. Move-Item 첫 번째 항목을 Textfiles 파일로 이동한 다음 파일이 이미 있음을 설명하는 오류를 표시합니다.

또한 기본적으로 Get-ChildItem 숨겨진 파일을 이동하지 않습니다. 숨겨진 파일을 이동하려면 Get-ChildItem 매개 변수를 사용합니다.

이 명령은 MyCompanyHKLM\Software 레지스트리 키 내의 레지스트리 키와 값을 MyNewCompany 키로 이동합니다. 와일드카드 문자(*)는 키 자체가 아니라 MyCompany 키의 내용을 이동해야 했음을 나타냅니다. 이 명령에서 선택적 경로 및 대상 매개 변수 이름은 생략됩니다.

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

이 명령은 Logs[Sept`06] 디렉터리(및 해당 내용)를 Logs[2006] 디렉터리로 이동합니다.

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

원래 디렉터리 이름에는 왼쪽 대괄호 및 오른쪽 대괄호 문자( 및 )가 포함되므로 [ 매개 변수는 ]대신 사용됩니다. 또한 경로는 작은따옴표(')로 묶어 백틱 기호(`)가 잘못 해석되지 않도록 합니다.

Destination 매개 변수는 잘못 해석될 수 있는 대괄호를 포함하므로 작은따옴표로 묶어야 합니다.

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

경로가 포함된 문자열을 이 cmdlet에 파이프할 수 있습니다.

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 이동된 항목을 나타내는 개체를 반환합니다.

PowerShell에는 Move-Item에 대한 다음과 같은 별칭들이 포함되어 있습니다.

• 모든 플랫폼:

  • mi
  • move

• Windows:

  • mv

• 이 cmdlet은 동일한 공급자가 지원하는 드라이브 간에 파일을 이동하지만 동일한 드라이브 내에서만 디렉터리를 이동합니다.

• Move-Item 명령은 항목의 속성, 내용 및 자식 항목을 이동하므로 모든 이동은 기본적으로 재귀적입니다.

• 이 cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 Get-PSProvider입력합니다. 추가 정보는 about_Providers를 참조하십시오.