Azure PowerShell genel ayarlarını yapılandırma

2025-07-02

Azure PowerShell, geri dönülemez değişiklik uyarı mesajlarını devre dışı bırakma seçeneği gibi çeşitli genel ayar seçenekleri sunar. Az PowerShell modülünün 9. sürümünden önce, bu genel ayarları yapılandırmak için merkezi veya ayrıntılı bir yöntem yoktu.

Merkezi yapılandırma

Az PowerShell modülü sürüm 9 ve üzeri, Azure PowerShell için genel ayarların yapılandırmasını yönetmeye yönelik cmdlet'leri içerir. Bu *-AzConfig cmdlet'ler Az.Accounts PowerShell modülünün bir parçasıdır:

Granüler ayarlar

Belirli bir kapsamda geçerli olan ayarları uygulayabilirsiniz. Kapsamı parametresi için geçerli değerler şunlardır:

Current User: Ayar uygulanırken varsayılan kapsam.
Process: Bu ayar yalnızca geçerli PowerShell oturumuna uygulanır.
Default: Varsayılan değerin değişmediği salt okunur bir kapsam.
Environment: Değerin bir ortam değişkeni aracılığıyla yapılandırıldığı salt okunur kapsam.

Kapsamların yanı sıra, ayarları tüm Az PowerShell modüllerine veya yalnızca tek bir modüle uygulayabilirsiniz. AppliesTo parametresini kullanarak, ayarın ne kadar geniş uygulanmasını istediğinizi belirtebilirsiniz. Az değeri ayarın Azure PowerShell'in parçası olan tüm modüllere uygulandığını gösterir.

Yapılandırma seçenekleri

*-AzConfig cmdlet'leri ile ayarlayabileceğiniz çok sayıda yapılandırma seçeneği vardır. Bu yapılandırma seçeneklerinin çoğu bu bölümde gösterilmiştir. *-AzConfig cmdlet'leri ile ayarlayabileceğiniz Azure PowerShell yapılandırma seçeneklerinin tam listesini görmek için aşağıdaki komutu çalıştırın.

Get-AzConfig | Format-List

Yükseltme bildirimleri

Azure PowerShell sürüm yükseltmeleri için araç içi bildirimler, Az PowerShell modülü sürüm 10.3.0'da yayımlanan bir özelliktir. Azure PowerShell'in yeni bir sürümü kullanılabilir olduğunda, etkileşimli PowerShell oturumunuzda bir yükseltme bildirimi görüntülenir.

Yükseltme bildirimlerinin etkinleştirilip etkinleştirilmediğini belirlemek için, aşağıdaki örnekte gösterildiği gibi checkForUpgrade Get-AzConfig parametresiyle cmdlet'ini kullanın.

Get-AzConfig -CheckForUpgrade

Azure PowerShell için yükseltme bildirimlerini etkinleştirmek amacıyla, aşağıdaki örnekte gösterildiği gibi Update-AzConfig cmdlet'ini CheckForUpgrade parametresi ve $true değeriyle kullanın.

Update-AzConfig -CheckForUpgrade $true

Yükseltme bildirimlerini kapatmak için, aşağıdaki örnekte gösterildiği gibi Update-AzConfig cmdlet'ini, CheckForUpgrade parametresi ve $false değeri ile kullanın.

Update-AzConfig -CheckForUpgrade $false

Varsayılan abonelik

Varsayılan olarak, Az PowerShell modülü sürüm 12.0.0'dan başlayarak, birden çok aboneliğe erişiminiz varsa oturum açmak için bir Azure aboneliği seçmeniz istenir.

Etkileşimli olarak her oturum açışınızda abonelik seçmenizin istenmesini önlemek için, aşağıdaki örnekte gösterildiği gibi varsayılan aboneliğinizi ayarlamak için Update-AzConfig parametresiyle cmdlet'ini kullanın.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Uyarı

Varsayılan bağlamın aboneliğiyle karıştırılmaması için DefaultSubscriptionForLogin yapılandırması yalnızca Azure'da kimlik doğrulaması yapılırken geçerli olur.

Örnek bulma

Örnek bulmayı devre dışı bırakma ayarı, meta veri uç noktasına erişilemeyen özel bulutlar veya Azure Stack ortamları gibi durumlar için tasarlanmıştır. Örnek bulma, yetkiyi doğrulamak için https://login.microsoft.com/'den yetkilendirme meta verilerini almayı içerir. Bu ayarı etkinleştirerek (trueolarak ayarlayarak), hem örnek bulma hem de yetkili doğrulamayı devre dışı bırakırsınız. Bu nedenle, yapılandırılan yetki veren sunucunun geçerli ve güvenilir olduğundan emin olmak önemlidir.

Hem örnek bulma hem de yetkili doğrulamasını devre dışı bırakmak için bu ayarı etkinleştirin (trueolarak ayarlayın).

Update-AzConfig -DisableInstanceDiscovery $true

Önemli değişiklik uyarı mesajları

Tüm Az modüllerdeki cmdlet'ler için değişiklik hatası uyarı iletilerini devre dışı bırakmak amacıyla, aşağıdaki örnekte gösterildiği gibi Update-AzConfig parametresiyle birlikte DisplayBreakingChangeWarning cmdlet'ini kullanın.

Update-AzConfig -DisplayBreakingChangeWarning $false

Az.Compute modülündeki cmdlet'ler için sadece önemli değişiklik uyarısı iletisini devre dışı bırakmak üzere, aşağıdaki örnekte gösterildiği gibi hem Update-AzConfig hem de AppliesTo parametreleriyle cmdlet'ini kullanın.

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

Bu senaryoda, önemli değişiklik uyarı mesajı Az.Compute dışındaki tüm Az PowerShell modüllerindeki cmdlet'ler için etkin olmaya devam eder.

Azure bölge tanımlaması

Azure müşterileri kaynakları birkaç farklı bölgeye dağıtmayı seçebilir. Bazen müşteriler, aynı hizmetleri sunan yakın bölgeleri seçerek maliyetleri azaltabilir. Yakınlardaki bir bölge tanımlanırsa, bu bölgeyi gelecekteki dağıtımlar için seçmeniz amacıyla bir ileti görüntülenir.

Bölge öneri iletilerini devre dışı bırakmak için, aşağıdaki örnekte gösterildiği gibi Update-AzConfig parametresiyle cmdlet'ini kullanın.

Update-AzConfig -DisplayRegionIdentified $false

Azure bölgeleri hakkında daha fazla bilgi için bkz. sizin için doğru Azure bölgesini seçme.

Gizli bilgiler uyarısı.

Azure PowerShell, bir komutun çıkışında olası bir gizli dizi tanımladığında hassas bilgileri korumanıza yardımcı olmak için varsayılan olarak sürüm 12.0.0'dan başlayarak bir uyarı iletisi görüntüler.

Aşağıdaki örnekte, uyarı iletisini devre dışı bırakmak için Update-AzConfig cmdlet'i kullanılır.

Update-AzConfig -DisplaySecretsWarning $false

Anketler

Azure PowerShell'i kullanırken, bize deneyiminiz hakkında bilgi vermek için bir ankete katılmaya davet edilebilirsiniz. Bu verilerin sağladığı içgörüleri takdir etmekle birlikte, herkesin anketi tamamlaması istenmediğini anlıyoruz.

Aşağıdaki örnekte gösterildiği gibi Update-AzConfig cmdlet'iyle anketlere katılmanın istenmesini devre dışı bırakabilirsiniz.

Update-AzConfig -DisplaySurveyMessage $false

Veri toplama

Azure PowerShell cmdlet'leri, müşteri deneyimini geliştirmek için varsayılan olarak Microsoft'a telemetri verileri gönderir. Daha fazla bilgi için gizlilik bildirimimize bakın: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Hata kayıtları

Varsayılan olarak, Azure PowerShell hata kayıtları $HOME/.Azure/ErrorRecordsolarak yazılır.

Kalıcı hata kayıtlarını devre dışı bırakmak için, aşağıdaki örnekte gösterildiği gibi enableErrorRecordsPersistence Update-AzConfig parametresiyle cmdlet'ini kullanın.

Update-AzConfig -EnableErrorRecordsPersistence $false

Web Hesabı Yöneticisi (WAM)

Az PowerShell modülü sürüm 12.0.0'dan başlayarak, Windows sistemleri Web Hesabı Yöneticisi'ni (WAM) ve Linux ve macOS sistemleri varsayılan olarak tarayıcı tabanlı oturum açmayı kullanır.

Windows 10 ve sonraki sürümlerde veya Windows Server 2019 ve sonraki sürümlerde, Az 12.0.0 ve üzeri ile tarayıcı tabanlı oturum açmayı kullanmak için Azure PowerShell ile WAM'yi devre dışı bırakmanız gerekir. AŞAĞıDAKI komutu kullanarak WAM'yi devre dışı bırakın ve Az 12.0.0'dan önceki varsayılan tarayıcı tabanlı oturum açmaya dönün.

Update-AzConfig -EnableLoginByWam $false

Az PowerShell modülü sürüm 12.0.0'dan başlayarak, birden çok aboneliğe erişiminiz varsa oturum açmak için bir Azure aboneliği seçmeniz istenir.

Yeni oturum açma deneyimi devre dışı bırakıldığında ve birden çok aboneliğe erişiminiz olduğunda, Connect-AzAccountile bir abonelik belirtmediğiniz sürece Azure'ın döndürdüğü ilk abonelikte oturum açarsınız. Komutlar varsayılan olarak bu abonelikte çalıştırılır. Bu davranış, örneğin döndürülen ilk abonelik bir üretim ortamıysa tehlikeli olabilir.

Yeni oturum açma deneyimini devre dışı bırakmak için aşağıdaki örnekte gösterildiği gibi Update-AzConfig cmdlet'ini kullanın.

Update-AzConfig -LoginExperienceV2 Off

Ayarları kopyalama

Ayarlarınızı bir ortamdan diğerine çoğaltmak için Export-AzConfig cmdlet'ini kullanarak ayarları bir JSON dosyasına aktarırsınız.

Export-AzConfig -Path $HOME\AzConfig.json

Ayarlarınızı içeri aktarmak için Import-AzConfig cmdlet'ini kullanın ve daha önce dışarı aktarılan JSON dosyasına başvurun.

Import-AzConfig -Path $HOME\AzConfig.json

Yapılandırmayı temizleme

Bir veya daha fazla Azure PowerShell genel ayarının yapılandırma ayarını varsayılana sıfırlamak için Clear-AzConfig cmdlet'ini kullanın. Aşağıdaki örnekte, DefaultSubscriptionForLogin ayarı temizlenir.

Clear-AzConfig -DefaultSubscriptionForLogin