PowerShell 스크립트가 다른 폴더에서 파일을 못 찾을 때, $PSScriptRoot로 경로 고치기

PowerShell 스크립트가 다른 폴더에서 파일을 못 찾을 때, $PSScriptRoot로 경로 고치기

AI 실무노트 · PowerShell

PowerShell 스크립트가 다른 폴더에서 파일을 못 찾을 때, $PSScriptRoot로 경로 고치기

AI가 만든 PowerShell 스크립트에 .\settings.txt를 읽는 줄이 있다고 가정해 보겠습니다. 스크립트가 있는 폴더에서는 실행이 잘되지만 다른 폴더에서 호출하면 파일을 찾지 못합니다. 더 알아차리기 어려운 경우도 있습니다. 현재 폴더에 이름이 같은 파일이 있으면 그 파일을 읽고 실행을 계속합니다.

스크립트와 함께 배포하는 파일이라면 $PSScriptRoot로 경로를 조합하세요. .\는 PowerShell의 현재 작업 위치를 가리킵니다. $PSScriptRoot는 실행 중인 .ps1 파일이 들어 있는 폴더의 전체 경로입니다. 두 위치는 스크립트를 호출하는 방법에 따라 달라질 수 있습니다.

현재 작업 위치를 바꿔 읽는 파일을 확인합니다

빈 실습 폴더 C:\work\ps-path-demo 아래에 script [kit]과 launch를 만드세요. script [kit]의 settings.txt에는 mode=script 한 줄을 저장합니다. launch는 처음에 비워 둡니다. 실습 폴더를 다른 곳에 만들었다면 아래 $demo 값에 그 경로를 넣으세요.

왼쪽 실행 폴더의 빨간 설정 파일은 읽지 않고 오른쪽 스크립트와 같은 폴더에 있는 초록 설정 파일을 읽는 경로를 표시한 개념도
실행 위치와 스크립트 폴더가 다를 때 읽을 파일을 구분한 개념도입니다. 실제 PowerShell 화면이 아닙니다. 제작: AI 실무노트, OpenAI 이미지 생성.

script [kit]에 read-settings.ps1 파일을 만들고 아래 한 줄을 저장하세요.

Get-Content -LiteralPath '.\settings.txt' -ErrorAction Stop

PowerShell에서 아래 명령을 실행해 보세요. 두 번 모두 같은 .ps1을 호출합니다.

$demo = 'C:\work\ps-path-demo'
Set-Location -LiteralPath "$demo\script [kit]"
& "$demo\script [kit]\read-settings.ps1"

Set-Location -LiteralPath "$demo\launch"
& "$demo\script [kit]\read-settings.ps1"

첫 번째 호출은 mode=script를 출력합니다. 두 번째 호출은 launch에 설정 파일이 없어서 오류가 납니다. 이번에는 launch\settings.txt를 만들어 mode=caller 한 줄을 저장하고, launch에서 다시 호출하세요. 이번 출력은 mode=caller입니다. 스크립트를 전체 경로로 호출해도 스크립트 안의 상대 경로는 여전히 현재 작업 위치를 기준으로 해석됩니다.

스크립트 옆에 있는 파일의 경로를 조합합니다

read-settings.ps1의 내용을 아래 두 줄로 바꾸고 저장하세요. Join-Path는 스크립트가 있는 폴더의 경로에 settings.txt를 붙입니다. Get-Content -LiteralPath는 예제의 [kit]처럼 경로에 들어 있는 대괄호를 검색 패턴으로 해석하지 않고 그대로 읽습니다.

$settingsPath = Join-Path -Path $PSScriptRoot -ChildPath 'settings.txt'
Get-Content -LiteralPath $settingsPath -ErrorAction Stop
  • 두 폴더에서 같은 설정을 읽습니다. 앞에서 실행한 호출 명령을 다시 실행하면 script [kit]에서도 launch에서도 mode=script가 출력됩니다. launch에 동명 파일이 있어도 결과는 같습니다.
  • 필요한 파일이 없으면 오류가 납니다. script [kit]의 합성 설정 파일만 치운 뒤 launch에서 다시 호출해 보세요. 예제는 지정한 설정 파일을 찾지 못했다는 오류를 냅니다. -ErrorAction Stop을 붙여 이 읽기 오류가 나면 실행을 중단하도록 했습니다.

설정 파일을 스크립트와 별도 폴더에서 관리한다면, 호출할 때 의도한 설정의 전체 경로를 인수로 전달하세요. 스크립트 옆 파일을 읽도록 경로를 조합하는 방법은 설정 파일을 함께 배포하는 경우에 맞습니다.

AI에게 수정과 재현을 함께 요청합니다

이 .ps1은 스크립트와 함께 배포하는 settings.txt를 읽어야 합니다. 현재 작업 위치를 바꾸지 말고 $PSScriptRoot 기준으로 경로를 조합해 주세요. 다른 폴더에서 실행할 때 그 폴더에 같은 이름의 파일이 있어도 스크립트 옆 파일을 읽는지, 스크립트 옆 파일이 없으면 오류가 나는지 합성 파일로 확인해 주세요.

댓글

이 블로그의 인기 게시물

ChatGPT 프로젝트로 반복 업무 맥락을 정리하는 방법

AI 번역문에서 ‘최대·별도’가 사라졌다면: Google Docs 사본으로 원문 대조하기

AI 회의록의 제안이 확정 업무로 바뀌었다면: 발언 근거로 실행 항목 확인하기