Sdílet prostřednictvím

Konfigurace globálního nastavení Azure PowerShellu

  • Článek

Azure PowerShell nabízí různá globální nastavení, jako je například možnost zakázat zprávy upozornění na změnu způsobující chybu. Před verzí 9 modulu Az PowerShellu neexistovala žádná centralizovaná ani podrobná metoda konfigurace těchto globálních nastavení.

Centralizovaná konfigurace

Modul Az PowerShell verze 9 a vyšší zahrnuje rutiny pro správu konfigurace globálního nastavení pro Azure PowerShell. Tyto *-AzConfig rutiny jsou součástí modulu Az.Accounts PowerShell:

Podrobná nastavení

Můžete použít nastavení, která jsou platná v určitém rozsahu. Platné hodnoty parametru Scope jsou:

  • Current User: Výchozí obor při použití nastavení.
  • Process: Nastavení se použije jenom pro aktuální relaci PowerShellu.
  • Default: Obor jen pro čtení, ve kterém se výchozí hodnota nezměnila.
  • Environment: Obor jen pro čtení, ve kterém je hodnota nakonfigurovaná prostřednictvím proměnné prostředí.

Kromě oborů můžete nastavení použít pro všechny moduly Az PowerShellu nebo jenom jeden modul. Pomocí parametru AppliesTo můžete určit, jak široké má být nastavení použito. Hodnota Az označuje, že nastavení se použije pro všechny moduly, které jsou součástí Azure PowerShellu.

Možnosti konfigurace

V rutinách můžete nastavit *-AzConfig celou řadu možností konfigurace. Mnoho z těchto možností konfigurace se zobrazuje v této části. Spuštěním následujícího příkazu zobrazíte úplný seznam možností konfigurace Azure PowerShellu *-AzConfig , které můžete nastavit pomocí rutin.

Get-AzConfig | Format-List

Oznámení o upgradu

Oznámení v nástroji pro upgrady verzí Azure PowerShellu jsou funkce vydaná v modulu Az PowerShell verze 10.3.0. Pokud je k dispozici nová verze Azure PowerShellu, zobrazí se v interaktivní relaci PowerShellu oznámení o upgradu.

Pokud chcete zjistit, jestli jsou povolená oznámení o upgradu, použijte rutinu Get-AzConfigs parametrem CheckForUpgrade , jak je znázorněno v následujícím příkladu.

Get-AzConfig -CheckForUpgrade

Pokud chcete povolit oznámení o upgradu pro Azure PowerShell, použijte rutinu Update-AzConfigs parametrem CheckForUpgrade a $true jeho hodnotou, jak je znázorněno v následujícím příkladu.

Update-AzConfig -CheckForUpgrade $true

Pokud chcete vypnout oznámení o upgradu, použijte rutinu Update-AzConfigs parametrem CheckForUpgrade a $false jeho hodnotou, jak je znázorněno v následujícím příkladu.

Update-AzConfig -CheckForUpgrade $false

Výchozí předplatné

Ve výchozím nastavení se od modulu Az PowerShell verze 12.0.0 zobrazí výzva k výběru předplatného Azure pro přihlášení.

Pokud chcete zabránit zobrazení výzvy k výběru předplatného pokaždé, když se interaktivně přihlásíte, použijte rutinu Update-AzConfig s parametrem DefaultSubscriptionForLogin k nastavení výchozího předplatného, jak je znázorněno v následujícím příkladu.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Poznámka:

Nezaměňovat s předplatným výchozího kontextu se konfigurace DefaultSubscriptionForLogin projeví pouze při ověřování v Azure.

Zprávy upozornění na změnu způsobující chybu

Pokud chcete zakázat upozornění na chybu změn pro rutiny ve všech modulech Az, použijte rutinu DisplayBreakingChangeWarningUpdate-AzConfig s parametrem, jak je znázorněno v následujícím příkladu:

Update-AzConfig -DisplayBreakingChangeWarning $false

Pokud chcete zakázat zprávu upozornění na změnu způsobující chybu speciálně pro rutiny v modulu Az.Compute , použijte tuto Update-AzConfig rutinu s parametry DisplayBreakingChangeWarning a AppliesTo , jak je znázorněno v následujícím příkladu:

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

V tomto scénáři zůstane upozornění na změnu způsobující chybu aktivní pro rutiny ve všech modulech Az PowerShellu s výjimkou Az.Compute.

Identifikace oblastí Azure

Zákazníci Azure se můžou rozhodnout nasadit prostředky v několika různých oblastech. Zákazníci můžou někdy snížit náklady výběrem blízkých oblastí nabízejících stejné služby. Pokud je zjištěna okolní oblast, zobrazí se ve zprávě zpráva, kterou chcete zvolit pro budoucí nasazení.

Pokud chcete zakázat zprávy doporučení oblasti, použijte rutinu Update-AzConfig s parametrem DisplayRegionIdentified , jak je znázorněno v následujícím příkladu.

Update-AzConfig -DisplayRegionIdentified $false

Další informace o oblastech Azure najdete v tématu Volba správné oblasti Azure.

Zobrazení upozornění na tajné kódy

Azure PowerShell ve výchozím nastavení zobrazí zprávu s upozorněním počínaje verzí 12.0.0, která pomáhá chránit citlivé informace při identifikaci potenciálního tajného kódu ve výstupu příkazu.

V následujícím příkladu Update-AzConfig se rutina používá k zakázání zprávy upozornění.

Update-AzConfig -DisplaySecretsWarning $false

Průzkumy

Při použití Azure PowerShellu můžete být pozváni, abyste se mohli zúčastnit průzkumu a sdělit nám o svém prostředí. I když si vážíme přehledů, které tato data poskytují, chápeme, že nechceme, aby byli všichni vyzváni k dokončení průzkumu.

Pomocí rutiny můžete zakázat zobrazení výzvy k účasti na průzkumech Update-AzConfig , jak je znázorněno v následujícím příkladu.

Update-AzConfig -DisplaySurveyMessage $false

Shromažďování dat

Rutiny Azure PowerShellu ve výchozím nastavení odesílají do Microsoftu telemetrická data, aby se zlepšilo uživatelské prostředí. Další informace najdete v našem prohlášení o zásadách ochrany osobních údajů: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Záznamy chyb

Ve výchozím nastavení se záznamy chyb Azure PowerShellu zapisují do $HOME/.Azure/ErrorRecords.

Pokud chcete zakázat trvalé záznamy chyb, použijte rutinu Update-AzConfig s parametrem EnableErrorRecordsPersistence , jak je znázorněno v následujícím příkladu.

Update-AzConfig -EnableErrorRecordsPersistence $false

Správce webových účtů (WAM)

Počínaje modulem Az PowerShell verze 12.0.0 používají systémy Windows správce webových účtů (WAM) a systémy Linux a macOS ve výchozím nastavení přihlašování založené na prohlížeči.

Pokud chcete ve Windows 10 a novějším nebo Windows Serveru 2019 a novějším používat přihlášení založené na prohlížeči s Az 12.0.0 a novějším, musíte WAM zakázat pro použití s Azure PowerShellem. Pomocí následujícího příkazu zakažte WAM a vraťte se do přihlášení založeného na prohlížeči, výchozí před Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Nové přihlašovací prostředí

Počínaje modulem Az PowerShell verze 12.0.0, pokud máte přístup k více předplatným, zobrazí se výzva k výběru předplatného Azure pro přihlášení.

Pokud je nové přihlašovací prostředí zakázané a máte přístup k více předplatným, jste přihlášení k prvnímu předplatnému, které Azure vrátí, pokud nezadáte předplatné s Connect-AzAccount. Příkazy se ve výchozím nastavení spouštějí pro toto předplatné. Toto chování může být nebezpečné, například pokud je prvním vráceným předplatným produkční prostředí.

Pokud chcete nové přihlašovací prostředí zakázat, použijte rutinu Update-AzConfig , jak je znázorněno v následujícím příkladu.

Update-AzConfig -LoginExperienceV2 Off

Replikace nastavení

Pokud chcete replikovat nastavení z jednoho prostředí do jiného, použijte rutinu Export-AzConfig k exportu nastavení do souboru JSON.

Export-AzConfig -Path $HOME\AzConfig.json

K importu nastavení použijte rutinu Import-AzConfig a odkazujte na dříve exportovaný soubor JSON.

Import-AzConfig -Path $HOME\AzConfig.json

Vymazání konfigurace

Pokud chcete resetovat nastavení konfigurace jednoho nebo několika globálních nastavení Azure PowerShellu na výchozí hodnotu, použijte tuto rutinu Clear-AzConfig . V následujícím příkladu je nastavení DefaultSubscriptionForLogin vymazáno.

Clear-AzConfig -DefaultSubscriptionForLogin