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

  • Makale

Azure PowerShell, hataya neden olan değişiklik uyarı iletilerini devre dışı bırakma seçeneği gibi çeşitli genel 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. değeri Az , ayarın Azure PowerShell'in 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. Cmdlet'lerle *-AzConfig 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 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 $true değ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 $false değeri için cmdlet'ini kullanınUpdate-AzConfig.

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 DefaultSubscriptionForLogin parametresiyle cmdlet'ini kullanınUpdate-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.

Ö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, yetkiliyi doğrulamak için 'den https://login.microsoft.com/ yetkili meta verilerini 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 yetkili konağın 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

Hataya neden olan değişiklik uyarısı iletileri

Tüm Az modüllerindeki cmdlet'ler için hataya neden olan değişiklik uyarısı iletilerini devre dışı bırakmak için, aşağıdaki örnekte gösterildiği gibi cmdlet'ini parametresiyle DisplayBreakingChangeWarning birlikte kullanınUpdate-AzConfig:

Update-AzConfig -DisplayBreakingChangeWarning $false

Az.Compute modülündeki cmdlet'lere özel olarak hataya neden olan değişiklik uyarısı iletisini devre dışı bırakmak için, aşağıdaki örnekte gösterildiği gibi hem DisplayBreakingChangeWarning hem de 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.

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, gelecekteki dağıtımlar için seçebileceğiniz bölge bir ileti görüntülenir.

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

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 dizileri görüntüleme 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, Update-AzConfig uyarı iletisini devre dışı bırakmak için cmdlet 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 cmdlet'iyle Update-AzConfig 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ı öğesine $HOME/.Azure/ErrorRecordsyazılır.

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

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 sürümlerde tarayıcı tabanlı oturum açma özelliğini 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 deneyimi devre dışı bırakıldığında ve birden çok aboneliğe erişiminiz olduğunda, ile Connect-AzAccountbir 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 cmdlet'ini kullanın Update-AzConfig .

Update-AzConfig -LoginExperienceV2 Off

Ç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