Konfigurace globálního nastavení Azure PowerShellu
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-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 $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-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í 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.
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 Služby Azure Stack. Zjišťování instancí zahrnuje načtení metadat autority z https://login.microsoft.com/
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
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 DisplayBreakingChangeWarning
Update-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
Azure PowerShell
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro