Azure PowerShell의 오프라인 설치

아티클
03/05/2025

일부 환경에서는 인터넷 또는 PowerShell 갤러리에 연결할 수 없습니다. 이러한 상황에서는 이러한 방법 중 하나를 사용하여 Az PowerShell 모듈을 오프라인으로 설치할 수 있습니다.

메모

이 문서의 오프라인 설치 옵션에는 Az PowerShell 모듈을 다운로드하기 위해 인터넷에 액세스할 수 있는 시스템이 하나 이상 필요합니다. 이 모듈을 설치하려는 시스템과 다를 수 있습니다.

필수 구성 요소

지원되는 버전의 PowerShell 버전 7 이상 설치
Windows 운영 체제를 실행하는 경우에도 Windows PowerShell 5.1이 지원됩니다.

플랫폼 간

Az PowerShell 모듈에 대한 다음 설치 옵션은 Windows, Linux 및 macOS를 비롯한 모든 플랫폼에서 플랫폼 간으로 사용할 수 있습니다.

tar 압축 파일에서 설치

팁

이 설치 옵션을 사용하려면 tar 명령줄 유틸리티가 필요합니다. Windows 10 버전 1803 이상, 대부분의 Linux 배포판 및 현재 버전의 macOS에서 기본적으로 사용할 수 있습니다.

인터넷에 액세스할 수 있는 시스템에서 tar 보관 파일을 저장할 대상 경로를 정의합니다.
```
$downloadFolderPath = "$home/Downloads"
```

다운로드 폴더가 있는지 확인합니다. 그렇지 않으면 폴더를 만듭니다.

if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
    New-Item -Path $downloadFolderPath -ItemType Directory
}

GitHub의 최신 Az PowerShell 모듈 버전에 대한 tar 보관 파일의 URL을 확인합니다.

$tarSourceUrl = (
    Invoke-RestMethod -Uri https://api.github.com/repos/azure/azure-powershell/releases/latest |
    Select-Object -ExpandProperty assets | Where-Object content_type -eq 'application/x-gzip'
).browser_download_url

tar 파일 이름 및 대상 파일 경로를 변수에 저장합니다.

$fileName = Split-Path -Path $tarSourceUrl -Leaf
$downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName

PowerShell을 사용하여 GitHub에서 tar 보관 파일을 다운로드합니다.
```
Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath
```
Windows 운영 체제를 실행하는 경우 다운로드한 파일의 차단을 해제합니다.
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
메모

tar 보관 파일을 오프라인 시스템에 복사합니다. $downloadFilePath 및 $downloadFolderPath 변수를 정의하거나, 오프라인 시스템에서 다음 명령에 변수를 사용하는 대신 실제 값을 지정하세요.

tar 보관 파일의 내용을 추출합니다.

tar zxf $downloadFilePath -C $downloadFolderPath

Az PowerShell 모듈을 설치하려는 오프라인 시스템에서 추출된 파일 중 하나인 InstallModule.ps1 스크립트를 실행합니다.
```
.$downloadFolderPath/InstallModule.ps1
```

설치 저장 및 복사

인터넷 및 PowerShell 갤러리에 액세스할 수 있는 시스템을 사용하여 네트워크 위치에 Save-Module 또는 Save-PSResource Az PowerShell 모듈을 다운로드합니다. 이러한 명령은 Az 모듈 및 해당 종속성을 지정된 위치에 저장합니다. 저장된 모듈을 설치 원본으로 사용하여 오프라인 시스템에 복사합니다.

프라이빗 리포지토리에서 설치

로컬 네트워크에 프라이빗 리포지토리를 만들고 오프라인 시스템의 설치 원본으로 사용합니다. 자세한 내용은 프라이빗 PowerShellGet 리포지토리 작업하기을 참조하세요.

이 방법을 사용하면 단일 서버 또는 파일 공유에서 PowerShell 모듈을 캐시하여 PowerShellGet 사용하여 배포하거나 연결이 끊긴 시스템에 Microsoft.PowerShell.PSResourceGet 수 있습니다.

Windows

Windows에서 Windows PowerShell 버전 5.1을 사용하는 경우 MSI를 사용하여 Az PowerShell 모듈을 설치하는 옵션도 있습니다.

중요하다

MSI 설치 관리자는 Windows PowerShell 5.1에서만 작동합니다.

MSI 설치 관리자사용하여 Windows에 Azure PowerShell을 설치합니다.

문제 해결

Az PowerShell 모듈의 일반적인 설치 문제에 대한 해결 방법은 Az PowerShell 모듈 설치 문제 해결을 참조하세요.

또한 참조

저장 모듈
PSResource-저장

다음 단계

Az PowerShell 모듈을 사용하여 Azure 리소스를 관리하는 방법에 대한 자세한 내용은 Azure PowerShell시작하세요.

다음을 통해 공유