다음을 통해 공유


cmdlet 문제 해결

"경고: 패키지 '패키지 이름'을 다운로드하지 못했습니다." 문제를 해결하는 방법

또는 Update-Module 명령이 Install-Module 실패하는 경우가 있습니다. 조사에 따르면 일반적으로 네트워킹 문제입니다. TLS 1.2 이상을 사용하고 방화벽 규칙이 필요한 네트워크 엔드포인트에 대한 액세스를 허용하는지 확인합니다.

중요합니다

PowerShell 갤러리에는 TLS(전송 계층 보안) 1.2 이상이 필요합니다. TLS 1.2 이상을 사용하지 않는 경우 PowerShell 갤러리에 액세스하려고 할 때 오류가 발생합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.

[Net.ServicePointManager]::SecurityProtocol =
    [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

NuGet 공급자가 안정적으로 개선되도록 업데이트되었습니다. 다음 지침을 사용하여 NuGet 공급자의 최신 빌드를 설치한 다음 모듈을 설치하거나 업데이트합니다.

Install-PackageProvider NuGet -MinimumVersion 2.8.5.206 -Force

필요한 네트워크 엔드포인트

Update-* cmdlet은 Install-* PowerShell 갤러리에서 사용하는 네트워크 엔드포인트에 연결하려면 인터넷 액세스가 필요합니다.

네트워크 액세스 정책을 통해 다음 엔드포인트 중 TCP 포트 443에 연결할 수 있는지 확인합니다.

패키지 검색 및 다운로드에 필요한 호스트:

  • cdn.oneget.org
  • cdn.powershellgallery.com

PowerShell 갤러리 웹 사이트를 사용할 때 필요한 호스트:

  • *.powershellgallery.com - 웹 사이트
  • go.microsoft.com 그리고 aka.ms - 리디렉션 서비스

비고

이러한 엔드포인트가 변경되었습니다. 로 azureedge.net 끝나는 이전 엔드포인트는 더 이상 지원되지 않습니다.

PowerShell 갤러리와 상호 작용하는 Cmdlet은 PowerShell 갤러리 서비스가 중단될 때 예기치 않은 오류로 실패할 수 있습니다. PowerShell 갤러리의 현재 상태를 보려면 GitHub의 PowerShell 갤러리 상태 페이지를 참조하세요.