PowerShell Update-Help Error: 404 오류 해결하는 방법

PowerShell에서 발생하는 Update-Help 404 오류에 대한 해결책을 단계별로 안내합니다.

PowerShell Update-Help Error: 404 오류 해결하는 방법

PowerShell에서 Update-Help 명령어는 다양한 모듈에 대한 최신 도움말을 다운로드하고 설치하는 중요한 기능입니다. 하지만 이 명령어를 실행할 때 404 (The specified blob does not exist.) 오류가 발생하는 경우가 있습니다. 이 글에서는 이 오류가 발생하는 원인과 이를 해결하는 방법을 단계별로 설명하겠습니다.

1. 오류의 원인 분석

1.1 404 오류의 의미

HTTP 404 Not Found 오류는 요청한 리소스를 서버에서 찾을 수 없을 때 발생하는 일반적인 웹 오류입니다. PowerShell에서 이 오류가 발생하는 경우, 특정 모듈의 도움말 파일을 다운로드하려고 할 때 해당 파일이 Microsoft의 도움말 서버에 존재하지 않는 상황을 의미합니다.

1.2 PowerShell 모듈과 도움말 파일

PowerShell 모듈은 특정 기능을 수행하는 명령어와 기능을 포함하는 패키지입니다. 각 모듈에는 사용자 가이드를 제공하는 도움말 파일이 연결되어 있습니다. Update-Help 명령어는 이러한 파일들을 다운로드하여 로컬 시스템에 설치합니다. 오류는 다음과 같은 경우에 발생할 수 있습니다:

• 모듈의 최신 도움말 파일이 서버에 업로드되지 않은 경우
• 모듈이 더 이상 유지 관리되지 않거나 사용되지 않는 경우
• 네트워크 연결 문제로 서버에 접근할 수 없는 경우

2. 해결 방법

2.1 기본적인 문제 해결 시도

먼저, 간단한 방법으로 문제를 해결할 수 있는지 시도해 봅니다.

2.1.1 PowerShell을 관리자 권한으로 실행

일부 시스템에서는 관리자 권한이 없으면 도움말 파일을 업데이트할 수 없습니다. PowerShell을 관리자 권한으로 실행한 후 Update-Help 명령어를 다시 실행해 보세요.

Start-Process powershell -Verb runAs
Update-Help

2.1.2 인터넷 연결 확인

네트워크 연결 상태가 불안정하면 404 오류가 발생할 수 있습니다. 인터넷 연결 상태를 확인한 후, Update-Help 명령어를 다시 실행합니다.

Update-Help

2.2 특정 모듈 제외하기

때로는 특정 모듈에서만 오류가 발생할 수 있습니다. 이 경우, 오류를 발생시키는 모듈을 제외하고 나머지 모듈에 대해 도움말을 업데이트할 수 있습니다.

Update-Help -Module * -Force -ErrorAction SilentlyContinue

이 명령어는 오류가 발생한 모듈을 제외하고 다른 모듈의 도움말을 업데이트합니다.

2.3 캐시된 도움말 파일 삭제

오류가 계속 발생하면, 캐시된 이전 버전의 도움말 파일이 문제를 일으킬 수 있습니다. 이 경우 캐시된 파일을 삭제하고 다시 시도해 보세요.

2.3.1 캐시된 파일 삭제

다음 경로에서 캐시된 도움말 파일을 삭제합니다:

Remove-Item "$($env:ProgramData)\Microsoft\Windows\PowerShell\Help\*" -Recurse -Force

2.3.2 도움말 업데이트 재시도

캐시된 파일을 삭제한 후 Update-Help 명령어를 다시 실행합니다:

Update-Help -Force

2.4 대체 UI 문화 설정

기본적으로 PowerShell은 시스템의 UI 문화(언어 설정)를 사용하여 도움말 파일을 다운로드합니다. 그러나 특정 언어로 된 파일이 없을 경우, 영어(en-US)로 설정하여 시도해 볼 수 있습니다.

Update-Help -UICulture en-US

이 명령어는 영어 버전의 도움말 파일을 다운로드하여 오류를 피할 수 있게 해줍니다.

2.5 최신 버전의 PowerShell 설치

사용 중인 PowerShell 버전이 오래된 경우에도 오류가 발생할 수 있습니다. 최신 버전으로 업데이트하여 문제를 해결할 수 있습니다.

2.5.1 PowerShell 최신 버전 설치

다음 명령어를 사용하여 최신 버전의 PowerShell을 설치하거나 업데이트합니다:

winget install --id Microsoft.Powershell --source winget

설치가 완료되면 시스템을 재부팅하고 Update-Help 명령어를 다시 실행해 보세요.

3. 결론

PowerShell에서 Update-Help 명령어 실행 시 발생하는 404 오류는 여러 가지 원인으로 인해 발생할 수 있으며, 이를 해결하기 위해 다양한 접근 방법을 시도해 볼 수 있습니다.

오류가 계속 발생할 경우, Microsoft의 공식 문서나 지원 포럼에서 추가적인 도움을 찾는 것도 좋은 방법입니다.

 

참고: https://techcommunity.microsoft.com/t5/windows-powershell/update-help-error/m-p/3586777