다음을 통해 공유

Azure PowerShell 전역 설정 구성

  • 아티클

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의 일부인 모든 모듈에 적용됨을 나타냅니다.

구성 옵션

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

Get-AzConfig | Format-List

업그레이드 알림

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

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

Get-AzConfig -CheckForUpgrade

Azure PowerShell에 대한 업그레이드 알림을 사용하도록 설정하려면 다음 예제와 같이 CheckForUpgrade 매개 변수 및 $true 해당 값에 cmdlet을 사용합니다Update-AzConfig.

Update-AzConfig -CheckForUpgrade $true

업그레이드 알림을 해제하려면 다음 예제와 같이 CheckForUpgrade 매개 변수와 $false 해당 값에 cmdlet을 사용합니다Update-AzConfig.

Update-AzConfig -CheckForUpgrade $false

기본 구독

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

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

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

참고 항목

기본 컨텍스트의 구독과 혼동해서는 안 되며, DefaultSubscriptionForLogin 구성은 Azure에 인증할 때만 적용됩니다.

인스턴스 검색

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

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

Update-AzConfig -DisableInstanceDiscovery $true

호환성이 손상되는 변경 경고 메시지

모든 Az 모듈에서 cmdlet에 대한 호환성이 손상되는 변경 경고 메시지를 사용하지 않도록 설정하려면 다음 예제와 같이 매개 변수와 함께 DisplayBreakingChangeWarning cmdlet을 사용합니다Update-AzConfig.

Update-AzConfig -DisplayBreakingChangeWarning $false

Az.Compute 모듈의 cmdlet에 대해 특별히 호환성이 손상되는 변경 경고 메시지를 사용하지 않도록 설정하려면 다음 예제와 같이 DisplayBreakingChangeWarning 및 AppliesTo 매개 변수와 함께 cmdlet을 사용합니다Update-AzConfig.

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

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

Azure 지역 식별

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

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

Update-AzConfig -DisplayRegionIdentified $false

Azure 지역에 대한 자세한 내용은 적합한 Azure 지역 선택을 참조 하세요.

비밀 표시 경고

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

다음 예제에서는 cmdlet을 Update-AzConfig 사용하여 경고 메시지를 사용하지 않도록 설정합니다.

Update-AzConfig -DisplaySecretsWarning $false

설문

Azure PowerShell을 사용하는 경우 설문 조사에 참여하여 환경에 대해 알려줄 수 있습니다. 이 데이터가 제공하는 인사이트가 많은 도움이 되지만, 모든 사람이 설문 조사를 완료하라는 메시지를 받고 싶어하는 것은 아니라는 점을 알고 있습니다.

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

Update-AzConfig -DisplaySurveyMessage $false

데이터 수집

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

Update-AzConfig -EnableDataCollection $false

오류 레코드

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

영구 오류 레코드를 Update-AzConfig 사용하지 않도록 설정하려면 다음 예제와 같이 EnableErrorRecordsPersistence 매개 변수와 함께 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 구독을 선택하라는 메시지가 표시됩니다.

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

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

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