Windows PowerShell에서 명령으로 파일 다운로드하기 (Invoke-WebRequest)

사용 상황

HTTPS 주소의 파일을 지정한 경로로 다운로드하고 실패 시 저장 여부를 확인합니다.

적용 환경과 권한

Windows PowerShell 5.1 기준. Windows 시스템 cmdlet은 Windows 환경이 필요합니다. 일반 사용자 권한에서 시작하고 접근 실패는 메시지로 확인합니다. PowerShell 7 호환성은 별도 실행하지 않았습니다.

명령

$downloadUrl = 'https://example.com/'
$downloadDir = Join-Path $env:TEMP 'stamper-download-example'
New-Item -ItemType Directory -Path $downloadDir -Force | Out-Null
$downloadPath = Join-Path $downloadDir 'page.html'
if (Test-Path -LiteralPath $downloadPath) { throw '기존 파일이 있습니다. 다른 경로를 선택하세요.' }
Invoke-WebRequest -Uri $downloadUrl -UseBasicParsing -OutFile $downloadPath -ErrorAction Stop
Get-Item -LiteralPath $downloadPath | Select-Object Name, Length

경로·주소·패키지·포트는 자신의 대상에 맞게 지정합니다. 예제에 있는 기존 파일 보호 조건은 유지하세요.

출력과 해석 — 설명용

Name=page.html, Length는 서버 응답에 따라 달라집니다. HTML 다운로드 예제이며 프로그램 설치 예제가 아닙니다.

여기 적은 출력은 설명용입니다. 실제 격리 실행 범위와 결과는 아래 검증 기록을 기준으로 판단하세요.

검수 기준

• HTTPS 주소와 운영자 신뢰 여부 확인
• 파일 크기가 0이 아닌지 확인
• 배포 파일은 별도 게시된 SHA-256과 대조

실패 시 수정과 복구

401/403은 인증·접근 정책 확인, 404는 주소 확인, 프록시·TLS 실패는 조직 설정 확인. 인증 검사를 끄지 않는다. 실패 시 부분 파일을 확인하고 다른 이름으로 다시 받는다. 예제 폴더는 확인 후 제거할 수 있다.

검증 환경·검증일·출처

검토일: 2026-10-10.

실행 범위: 격리 임시 폴더에서 루프백 HTTP 성공·404 검증. 외부 HTTPS 주소는 문서 예시로 남긴다.

Microsoft 공식 문서

명령 인자 안내: LiteralPath는 경로 문자를 그대로 취급합니다. ErrorAction Stop은 처리 가능한 오류를 예외로 중단시킵니다. 조회 결과 없음과 실패는 동일하지 않습니다.