Konfigurace globálního nastavení Azure PowerShellu

  • Článek

Azure PowerShell podporuje několik globálních nastavení, jako je zakázání zpráv upozornění na změnu způsobující chybu. Před modulem Az PowerShell verze 9 neexistoval centralizovaný ani podrobný způsob konfigurace globálního nastavení pro Azure PowerShell.

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í

Nastavení, která jsou platná pouze v určitém oboru, můžete použít. Platné hodnoty parametru Scope jsou:

  • Current User. Výchozí hodnota při použití nastavení.
  • Process. Nastavení se použije jenom pro aktuální relaci PowerShellu.
  • Default. Rozsah jen pro čtení, ve kterém se výchozí hodnota nezměnila.
  • Environment. Rozsah 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 široce se má nastavení použít. Hodnota Az označuje, že nastavení se použije pro všechny dostupné moduly, které jsou součástí Azure PowerShellu.

Pokud chcete zakázat zprávu upozornění na změnu způsobující chybu pro rutiny v modulu Az.Compute , použijte rutinu Update-AzConfig 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.

Výchozí předplatné

Ve výchozím nastavení se při ověřování v Azure načtou všechna předplatná, ke kterým máte přístup. První předplatné, které vrátí Azure, se použije, pokud nezadáte předplatné s Connect-AzAccount. 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í.

Ke konfiguraci výchozího předplatného použijete rutinu Update-AzConfigs parametrem DefaultSubscriptionForLogin , 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.

Oznámení o upgradu

Oznámení v nástroji pro upgrady verzí Azure PowerShellu je 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

Identifikace oblastí Azure

Zákazníci Azure se můžou rozhodnout nasadit prostředky v mnoha různých oblastech. V některých případech můžou zákazníci snížit náklady výběrem blízkých oblastí nabízejících stejné služby. Pokud je identifikovaná okolní oblast, zobrazí se ve zprávě zpráva, která se má vybrat pro budoucí nasazení.

Zpráva o zakázání doporučení oblasti

V následujícím příkladu Update-AzConfig se rutina používá k zakázání zprávy doporučení oblasti:

Update-AzConfig -DisplayRegionIdentified $false

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

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