Share via


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

Azure PowerShell, hataya neden olan değişiklik uyarı iletilerini devre dışı bırakma gibi çeşitli genel ayarları destekler. Az PowerShell modülü 9 sürümünden önce, Azure PowerShell için genel ayarları yapılandırmanın merkezi veya ayrıntılı bir yolu 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:

Ayrıntılı ayarlar

Yalnızca belirli bir kapsamda geçerli olan ayarları uygulayabilirsiniz. Scope parametresi için geçerli değerler şunlardır:

  • Current User. Ayar uygulanırken varsayılan değerdir.
  • Process. Ayar yalnızca geçerli PowerShell oturumuna uygulanır.
  • Default. Varsayılan değerin değiştirilmediği salt okunur 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 parametresiyle, ayarın ne kadar geniş olmasını istediğinizi belirtebilirsiniz. değeri Az ayarın Azure PowerShell'in parçası olan tüm modüllere uygulandığını gösterir.

Az.Compute modülündeki cmdlet'ler için hataya neden olan değişiklik uyarısı iletisini devre dışı bırakmak için aşağıdaki örnekte gösterildiği gibi DisplayBreakingChangeWarning ve AppliesTo parametreleriyle cmdlet'ini kullanınUpdate-AzConfig.

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

Bu senaryoda, hataya neden olan değişiklik uyarı iletisi Az.Compute dışındaki tüm Az PowerShell modüllerindeki cmdlet'ler için etkin kalır.

Varsayılan abonelik

Varsayılan olarak, Azure'da kimlik doğrulaması yaptığınızda erişebileceğiniz tüm abonelikler alınır. Ile Connect-AzAccountbir abonelik belirtmediğiniz sürece Azure tarafından döndürülen ilk abonelik kullanılır. Bu davranış, örneğin döndürülen ilk abonelik bir üretim ortamıysa tehlikeli olabilir.

Varsayılan aboneliğinizi yapılandırmak için aşağıdaki örnekte gösterildiği gibi DefaultSubscriptionForLogin parametresiyle cmdlet'ini kullanırsınızUpdate-AzConfig.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Not

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.

Yükseltme bildirimleri

Azure PowerShell'in 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 Get-AzConfig etkinleştirilip etkinleştirilmediğini belirlemek için aşağıdaki örnekte gösterildiği gibi CheckForUpgrade parametresiyle cmdlet'ini kullanın.

Get-AzConfig -CheckForUpgrade

Azure PowerShell için yükseltme bildirimlerini etkinleştirmek için aşağıdaki örnekte gösterildiği gibi CheckForUpgrade parametresi ve $truedeğeri için cmdlet'ini kullanınUpdate-AzConfig.

Update-AzConfig -CheckForUpgrade $true

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

Update-AzConfig -CheckForUpgrade $false

Azure bölge tanımlaması

Azure müşterileri birçok farklı bölgede kaynak dağıtmayı seçebilir. Bazı durumlarda müşteriler aynı hizmetleri sunan yakın bölgeleri seçerek maliyetleri düşürebilir. Yakınlardaki bir bölge tanımlanırsa, gelecekteki dağıtımlar için seçilecek bölge bir ileti görüntülenir.

Bölge öneri iletisi devre dışı bırakleniyor

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

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.

Çoğaltma ayarları

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

Export-AzConfig -Path $HOME\AzConfig.json

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

Import-AzConfig -Path $HOME\AzConfig.json

Yapılandırma temizleniyor

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

Clear-AzConfig -DefaultSubscriptionForLogin