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

Azure PowerShell, yıkıcı değişiklik uyarı mesajlarını devre dışı bırakma seçeneği gibi çeşitli global ayarlar 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:

Ayrıntılı ayarlar

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 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 parçası olan tüm modüllere uygulandığını gösterir.

Yapılandırma seçenekleri

Cmdlet'lerle *-AzConfig 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. yeni bir Azure PowerShell 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 yükseltme bildirimlerini etkinleştirmek için, aşağıdaki örnekte gösterildiği gibi Update-AzConfig cmdlet’ini CheckForUpgrade parametresi ve $true değeri ile 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 değer olarak $false ile birlikte 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çtığı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>

Note

> varsayılan bağlamın aboneliğiyle karıştırılmamalıdır, DefaultSubscriptionForLogin yapılandırması yalnızca Azure kimlik doğrulaması yaparken geçerlilik kazanır.

Örnek bulma

Örnek keşfi devre dışı bırakma ayarı, meta veri uç noktasına erişilemeyen durumlar, örneğin özel bulutlar veya Azure Stack ortamları için tasarlanmıştır. Örnek keşfi, yetkiyi doğrulamak amacıyla https://login.microsoft.com/ 'den yetki meta verileri almayı içerir. Bu ayarı etkinleştirerek (olarak ayarlayarak true), hem örnek bulma hem de yetkili doğrulamasını devre dışı bırakırsınız. Bu nedenle, yapılandırılan yetkilendirme sunucusunun 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 (olarak ayarlayın true).

Update-AzConfig -DisableInstanceDiscovery $true

Önemli değişiklik uyarı mesajları

Tüm Az modüllerindeki cmdlet'ler için yıkıcı değişiklik uyarısı iletilerini devre dışı bırakmak için, aşağıdaki örnekte gösterildiği gibi cmdlet ile Update-AzConfig parametresini DisplayBreakingChangeWarning birlikte kullanın.

Update-AzConfig -DisplayBreakingChangeWarning $false

Az.Compute modülündeki cmdlet'lere özel olarak kırılan değişiklik uyarısı mesajını devre dışı bırakmak için, aşağıdaki örnekte gösterildiği gibi hem Update-AzConfig hem de AppliesTo parametreleriyle birlikte cmdlet'ini kullanın:

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.

Azure bölge kimliği

Azure müşteriler 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 belirlenirse, gelecekteki dağıtımlar için seçeceğiniz bölgeyi gösteren bir mesaj 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 bilgileri gösterme 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 12.0.0 sürümünden başlayarak bir uyarı iletisi görüntüler.

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

Update-AzConfig -DisplaySecretsWarning $false

Anketler

Azure PowerShell 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 cmdlet'iyle Update-AzConfig anketlere katılmanın istenmesini devre dışı bırakabilirsiniz.

Update-AzConfig -DisplaySurveyMessage $false

Veri toplama

Varsayılan olarak, Azure PowerShell cmdlet'leri müşteri deneyimini geliştirmek için telemetri verilerini Microsoft 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/ErrorRecords'e yazılır.

Kalıcı hata kaydı kaydını devre dışı bırakmak için aşağıdaki örnekte gösterildiği gibi Update-AzConfig parametresini kullanarak 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 tarayıcı tabanlı oturum açmayı Az 12.0.0 ve üzeri sürümlerde kullanmak için WAM'yi Azure PowerShell ile kullanmak üzere 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

Yeni oturum açma deneyimi

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 yöntemi devre dışı bırakıldığında ve birden çok aboneliğe erişiminiz olduğunda, Connect-AzAccount ile bir abonelik belirtmediğiniz sürece Azure ilk aboneliğe giriş yapar. 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 cmdlet'ini kullanın Update-AzConfig .

Update-AzConfig -LoginExperienceV2 Off

Replikasyon 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ırmayı temizle

Bir veya daha fazla Azure PowerShell genel ayarı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
  • Last updated on