Konfigurace globálního nastavení Azure PowerShell

Azure PowerShell nabízí různá globální nastavení, 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 PowerShellu Az 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 pouze pro aktuální relaci PowerShellu.
  • Default: Obor jen pro čtení, ve kterém se výchozí hodnota nezměnila.
  • Environment: Obor jen pro čtení, kde je hodnota nakonfigurována proměnnou 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 u všech modulů, které jsou součástí Azure PowerShell.

Možnosti konfigurace

Pomocí *-AzConfig cmdletů můžete nastavit 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 PowerShell, které můžete nastavit pomocí rutin *-AzConfig.

Get-AzConfig | Format-List

Oznámení o upgradu

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

Pokud chcete zjistit, jestli jsou povolená oznámení o upgradu, použijte rutinu Get-AzConfig s 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-AzConfig s parametrem CheckForUpgrade a parametrem $true, 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-AzConfig s 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í, počínaje modulem PowerShellu Az 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 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>

Note

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

Zjišťování instancí

Nastavení zakázání zjišťování instancí je určeno pro situace, kdy je koncový bod metadat nepřístupný, například v privátních cloudech nebo v prostředích Azure Stack. Zjišťování instancí zahrnuje načtení metadat autority z https://login.microsoft.com/ pro ověření autority. Když toto nastavení povolíte (nastavíte ho na true), zakážete zjišťování instancí i ověření autority. Proto je nezbytné zajistit, aby nakonfigurovaný hostitel autority byl platný a důvěryhodný.

Pokud chcete zakázat zjišťování instancí i ověřování autority, povolte toto nastavení (nastavte na true).

Update-AzConfig -DisableInstanceDiscovery $true

Upozornění na nekompatibilní změny

Pokud chcete zakázat upozornění na zásadní změny pro rutiny ve všech modulech Az, použijte rutinu Update-AzConfig s parametrem DisplayBreakingChangeWarning, jak je vidět 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 oblasti Azure

Zákazníci Azure si mohou zvolit nasadit prostředky v několika různých regionech. 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 blízká oblast, zobrazí se zpráva s oblastí, kterou lze 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 Azure oblastech najdete v tématu Choose the right Azure region for you.

Zobrazení upozornění na tajemství

Azure PowerShell ve výchozím nastavení zobrazí zprávu s upozorněním počínaje verzí 12.0.0, která vám pomůže 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 se Update-AzConfig cmdlet používá k zakázání zprávy upozornění.

Update-AzConfig -DisplaySecretsWarning $false

Průzkumy

Při používání Azure PowerShell můžete být pozváni, abyste se zúčastnili průzkumu, abyste nám řekli o svých zkušenostech. 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í příkazu Update-AzConfig můžete zakázat zobrazování výzev k účasti na průzkumech, jak je znázorněno v následujícím příkladu.

Update-AzConfig -DisplaySurveyMessage $false

Kolekce dat

Rutiny Azure PowerShell ve výchozím nastavení odesílají telemetrická data do Microsoft, 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 PowerShell 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 Az modul 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 používat přihlášení na základě prohlížeče ve Windows 10 a novějších verzích nebo ve Windows Server 2019 a novějších verzích s Az 12.0.0 a vyšší, musíte zakázat WAM pro použití s Azure PowerShell. 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 PowerShell Az 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, pomocí kterého se chcete přihlásit.

Pokud je nové přihlašovací prostředí zakázané a máte přístup k více předplatným, budete přihlášeni k prvnímu předplatnému, které vám Azure vrátí, pokud nezadáte konkrétní 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é, pokud je například 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

Chcete-li resetovat nastavení konfigurace jednoho nebo více Azure PowerShell globálních nastavení na výchozí, použijte rutinu Clear-AzConfig. V následujícím příkladu je nastavení DefaultSubscriptionForLogin vymazáno.

Clear-AzConfig -DefaultSubscriptionForLogin
  • Last updated on