Azure PowerShell genel ayarlarını yapılandırma
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
Azure PowerShell