Azure PowerShell 전역 설정 구성

2025-08-07

Azure PowerShell은 다양한 전역 설정을 제공하며, 예를 들어 중단 변경 경고 메시지를 비활성화하는 옵션이 있습니다. Az PowerShell 모듈의 버전 9 이전에는 이러한 글로벌 설정을 구성하기 위한 중앙 집중식 또는 세부적인 방법이 없었습니다.

중앙 집중식 구성

Az PowerShell 모듈 버전 9 이상에는 Azure PowerShell에 대한 전역 설정 구성을 관리하기 위한 cmdlet이 포함되어 있습니다. 다음 *-AzConfig cmdlet은 Az.Accounts PowerShell 모듈의 일부입니다.

세분화된 설정

특정 범위 내에서 효과적인 설정을 적용할 수 있습니다. Scope 매개 변수의 유효한 값은 다음과 같습니다.

Current User: 설정을 적용할 때의 기본 범위입니다.
Process: 이 설정은 현재 PowerShell 세션에만 적용됩니다.
Default: 기본값이 변경되지 않은 읽기 전용 범위입니다.
Environment: 환경 변수를 통해 값이 구성된 읽기 전용 범위입니다.

범위 외에도 모든 Az PowerShell 모듈 또는 단일 모듈에만 설정을 적용할 수 있습니다. AppliesTo 매개 변수를 사용하면 설정을 적용할 범위를 지정할 수 있습니다. Az 값은 설정이 Azure PowerShell의 일부인 모든 모듈에 적용됨을 나타냅니다.

구성 옵션

*-AzConfig cmdlet을 사용하면 다양한 구성 옵션을 설정할 수 있습니다. 이러한 구성 옵션의 대부분은 이 섹션에 나와 있습니다. *-AzConfig cmdlet으로 설정할 수 있는 Azure PowerShell 구성 옵션의 전체 목록을 보려면 다음 명령을 실행합니다.

Get-AzConfig | Format-List

업그레이드 알림

Azure PowerShell 버전 업그레이드에 대한 도구 내 알림은 Az PowerShell 모듈 버전 10.3.0에서 릴리스된 기능입니다. Azure PowerShell의 새 버전이 출시되면 대화형 PowerShell 세션에 업그레이드 알림이 표시됩니다.

업그레이드 알림이 사용하도록 설정되어 있는지 확인하려면 다음 예와 같이 Get-AzConfig 매개 변수와 함께 cmdlet을 사용합니다.

Get-AzConfig -CheckForUpgrade

Azure PowerShell에 대한 업그레이드 알림을 활성화하려면, 아래 예시와 같이 Update-AzConfig cmdlet을 사용하고 매개 변수로 CheckForUpgrade를, 값으로 $true를 사용하십시오.

Update-AzConfig -CheckForUpgrade $true

업그레이드 알림을 끄려면 다음 예제와 같이 Update-AzConfig cmdlet과 CheckForUpgrade 매개 변수를 사용하여 $false 값을 설정합니다.

Update-AzConfig -CheckForUpgrade $false

기본 구독

기본적으로 Az PowerShell 모듈 버전 12.0.0부터 여러 구독에 액세스할 수 있는 경우 로그인할 Azure 구독을 선택하라는 메시지가 표시됩니다.

대화형으로 로그인할 때마다 구독을 선택하라는 메시지가 표시되지 않도록 하려면 다음 예제와 같이 Update-AzConfig 매개 변수와 함께 cmdlet을 사용하여 기본 구독을 설정합니다.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

비고

기본 컨텍스트의 구독과 혼동하지 말고, DefaultSubscriptionForLogin 구성은 Azure에 인증할 때만 적용됩니다.

인스턴스 검색

인스턴스 검색 사용 안 함 설정은 프라이빗 클라우드 또는 Azure Stack 환경과 같이 메타데이터 엔드포인트에 액세스할 수 없는 상황을 위해 설계되었습니다. 인스턴스 검색에는 https://login.microsoft.com/에서 권한 메타데이터를 검색하여 권한의 유효성을 검사하는 작업이 포함됩니다. 이 설정을 사용하도록 설정하여(true설정) 인스턴스 검색 및 권한 유효성 검사를 모두 사용하지 않도록 설정합니다. 따라서 구성된 권한 호스트가 유효하고 신뢰할 수 있는지 확인해야 합니다.

인스턴스 검색과 권한 유효성 검사를 모두 사용하지 않도록 설정하려면 이 설정을 사용하도록 설정합니다(true로 설정).

Update-AzConfig -DisableInstanceDiscovery $true

중대한 변경 경고 메시지

모든 Az 모듈의 cmdlet에 대한 중단 변경 경고 메시지를 비활성화하려면 다음 예제와 같이 Update-AzConfig 매개 변수와 함께 DisplayBreakingChangeWarning cmdlet을 사용합니다.

Update-AzConfig -DisplayBreakingChangeWarning $false

Az.Compute 모듈의 cmdlet에 대해서만 중단 변경 경고 메시지를 사용하지 않도록 설정하려면 다음 예와 같이 Update-AzConfig 및 AppliesTo 매개 변수와 함께 cmdlet을 사용합니다.

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

이 시나리오에서는 Az.Compute를 제외한 모든 Az PowerShell 모듈의 cmdlet에 대해 변경 사항 경고 메시지가 활성 상태로 유지됩니다.

Azure 지역 식별

Azure 고객은 여러 다른 지역에 리소스를 배포하도록 선택할 수 있습니다. 경우에 따라 고객은 동일한 서비스를 제공하는 인근 지역을 선택하여 비용을 절감할 수 있습니다. 인접 지역이 식별되면 향후 배포에 사용할 지역을 선택하라는 메시지가 표시됩니다.

지역 권장 사항 메시지를 사용하지 않도록 설정하려면 다음 예와 같이 Update-AzConfig 매개 변수와 함께 cmdlet을 사용합니다.

Update-AzConfig -DisplayRegionIdentified $false

Azure 지역에 대한 자세한 내용은 자신에게 맞는 Azure 지역 선택을 참조하세요.

비밀 경고 표시

Azure PowerShell은 명령 출력에서 잠재적인 비밀을 식별할 때 중요한 정보를 보호하는 데 도움이 되도록 기본적으로 버전 12.0.0부터 경고 메시지를 표시합니다.

다음 예제에서는 Update-AzConfig cmdlet을 사용하여 경고 메시지를 비활성화합니다.

Update-AzConfig -DisplaySecretsWarning $false

설문 조사

Azure PowerShell을 사용하는 경우 설문 조사에 참여하여 경험에 대해 알려줄 수 있습니다. 이 데이터가 제공하는 인사이트를 높이 평가하지만, 설문 조사 참여를 요청받는 것을 원치 않는 사람들도 있다는 것을 이해합니다.

다음 예제와 같이 Update-AzConfig cmdlet을 사용하여 설문 조사에 참여하라는 메시지가 표시되지 않도록 설정할 수 있습니다.

Update-AzConfig -DisplaySurveyMessage $false

데이터 수집

기본적으로 Azure PowerShell cmdlet은 고객 환경을 개선하기 위해 원격 분석 데이터를 Microsoft에 보냅니다. 자세한 내용은 개인정보처리방침(aka.ms/privacy)을 참조하세요.

Update-AzConfig -EnableDataCollection $false

오류 레코드

기본적으로 Azure PowerShell 오류 레코드는 $HOME/.Azure/ErrorRecords에 기록됩니다.

영구 오류 레코드를 사용하지 않도록 설정하려면 다음 예제와 같이 Update-AzConfig 매개 변수와 함께 cmdlet을 사용합니다.

Update-AzConfig -EnableErrorRecordsPersistence $false

WAM(웹 계정 관리자)

Az PowerShell 모듈 버전 12.0.0부터 Windows 시스템은 WAM(웹 계정 관리자)을 사용하고 Linux 및 macOS 시스템은 기본적으로 브라우저 기반 로그인을 사용합니다.

Az 12.0.0 이상이 설치된 Windows 10 이상 또는 Windows Server 2019 이상에서 브라우저 기반 로그인을 사용하려면 Azure PowerShell과 함께 WAM을 사용하지 않도록 설정해야 합니다. 다음 명령을 사용하여 WAM을 사용하지 않도록 설정하고 Az 12.0.0 이전의 기본값인 브라우저 기반 로그인으로 돌아갑니다.

Update-AzConfig -EnableLoginByWam $false

Az PowerShell 모듈 버전 12.0.0부터 여러 구독에 액세스할 수 있는 경우 로그인할 Azure 구독을 선택하라는 메시지가 표시됩니다.

새 로그인 환경이 사용하지 않도록 설정되고 여러 구독에 액세스할 수 있는 경우 Connect-AzAccount로 구독을 지정하지 않는 한 Azure에서 반환하는 첫 번째 구독에 로그인됩니다. 명령은 기본적으로 이 구독에 대해 실행됩니다. 예를 들어 반환된 첫 번째 구독이 프로덕션 환경인 경우 이 동작은 위험할 수 있습니다.

새 로그인 환경을 사용하지 않도록 설정하려면 다음 예제와 같이 Update-AzConfig cmdlet을 사용합니다.

Update-AzConfig -LoginExperienceV2 Off

설정 복제

설정을 한 환경에서 다른 환경으로 복제하려면 Export-AzConfig cmdlet을 사용하여 설정을 JSON 파일로 내보냅니다.

Export-AzConfig -Path $HOME\AzConfig.json

설정을 가져오려면 Import-AzConfig cmdlet을 사용하고 이전에 내보낸 JSON 파일을 참조합니다.

Import-AzConfig -Path $HOME\AzConfig.json

구성 초기화

하나 이상의 Azure PowerShell 전역 설정의 구성 설정을 기본값으로 다시 설정하려면 Clear-AzConfig cmdlet을 사용합니다. 다음 예제에서는 DefaultSubscriptionForLogin 설정이 지워집니다.

Clear-AzConfig -DefaultSubscriptionForLogin