Konfigurera globala Azure PowerShell-inställningar
Azure PowerShell erbjuder olika globala inställningar, till exempel alternativet att inaktivera varningsmeddelanden om icke-bakåtkompatibla ändringar. Före version 9 av Az PowerShell-modulen fanns det ingen centraliserad eller detaljerad metod för att konfigurera dessa globala inställningar.
Centraliserad konfiguration
Az PowerShell-modulen version 9 och senare innehåller cmdletar för att hantera konfigurationen av globala inställningar för Azure PowerShell. Dessa *-AzConfig cmdletar ingår i PowerShell-modulen Az.Accounts :
Detaljerade inställningar
Du kan använda inställningar som är effektiva inom ett visst omfång. Giltiga värden för parametern Omfång är:
Current User: Standardomfånget när du tillämpar en inställning.Process: Inställningen tillämpas endast på den aktuella PowerShell-sessionen.Default: Ett skrivskyddat omfång där standardvärdet inte har ändrats.Environment: Ett skrivskyddat omfång där värdet konfigureras via en miljövariabel.
Förutom omfång kan du använda inställningar för alla Az PowerShell-moduler eller bara en enda modul.
Med parametern AppliesTo kan du ange hur bred du vill att inställningen ska tillämpas. Värdet Az anger att inställningen tillämpas på alla moduler som ingår i Azure PowerShell.
Konfigurationsalternativ
Det finns många konfigurationsalternativ som du kan ange med *-AzConfig cmdletarna. Många av dessa konfigurationsalternativ visas i det här avsnittet. Kör följande kommando för att se en fullständig lista över de Azure PowerShell-konfigurationsalternativ som du kan ange med *-AzConfig cmdletarna.
Get-AzConfig | Format-List
Uppgradera meddelanden
Meddelanden i verktyget för Uppgraderingar av Azure PowerShell-versioner är en funktion som släpps i Az PowerShell-modulversion 10.3.0. När en ny version av Azure PowerShell är tillgänglig visas ett uppgraderingsmeddelande i din interaktiva PowerShell-session.
Om du vill avgöra om uppgraderingsmeddelanden är aktiverade använder du cmdleten Get-AzConfig med parametern CheckForUpgrade , som du ser i följande exempel.
Get-AzConfig -CheckForUpgrade
Om du vill aktivera uppgraderingsmeddelanden för Azure PowerShell använder du cmdleten Update-AzConfig med parametern CheckForUpgrade och $true för dess värde, som du ser i följande exempel.
Update-AzConfig -CheckForUpgrade $true
Om du vill inaktivera uppgraderingsmeddelanden använder du cmdleten Update-AzConfig med parametern CheckForUpgrade och $false för dess värde, som du ser i följande exempel.
Update-AzConfig -CheckForUpgrade $false
Standardprenumeration
Från och med Az PowerShell-modul version 12.0.0 uppmanas du som standard att välja en Azure-prenumeration att logga in med om du har åtkomst till flera prenumerationer.
Om du vill förhindra att du uppmanas att välja en prenumeration varje gång du loggar in interaktivt använder du cmdleten Update-AzConfig med parametern DefaultSubscriptionForLogin för att ange din standardprenumeration, som du ser i följande exempel.
Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>
Kommentar
För att inte förväxlas med prenumerationen för standardkontexten börjar DefaultSubscriptionForLogin-konfigurationen endast gälla när du autentiserar till Azure.
Instansidentifiering
Inställningen för att inaktivera identifiering av instanser är utformad för situationer där metadataslutpunkten inte är tillgänglig, till exempel i privata moln eller Azure Stack-miljöer. Instansidentifiering omfattar hämtning av utfärdarmetadata från https://login.microsoft.com/ för att verifiera utfärdaren. Genom att aktivera den här inställningen (ange den till true) inaktiverar du både instansidentifiering och verifiering av utfärdare. Därför är det viktigt att se till att den konfigurerade utfärdarens värd är giltig och tillförlitlig.
Om du vill inaktivera både identifiering av instanser och verifiering av utfärdare aktiverar du den här inställningen (ange den till true).
Update-AzConfig -DisableInstanceDiscovery $true
Varningsmeddelanden om icke-bakåtkompatibel ändring
Om du vill inaktivera varningsmeddelanden om icke-bakåtkompatibla ändringar för cmdletar i alla Az-moduler använder du cmdleten Update-AzConfig med parametern DisplayBreakingChangeWarning enligt följande exempel:
Update-AzConfig -DisplayBreakingChangeWarning $false
Om du vill inaktivera varningsmeddelandet om icke-bakåtkompatibel ändring specifikt för cmdletar i Az.Compute-modulen använder du cmdleten Update-AzConfig med parametrarna DisplayBreakingChangeWarning och AppliesTo enligt följande exempel:
Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute
I det här scenariot förblir varningsmeddelandet om icke-bakåtkompatibel ändring aktivt för cmdletar i alla Az PowerShell-moduler utom Az.Compute.
Identifiering av Azure-region
Azure-kunder kan välja att distribuera resurser i flera olika regioner. Ibland kan kunder minska kostnaderna genom att välja närliggande regioner som erbjuder samma tjänster. Om en närliggande region identifieras visar ett meddelande den region som ska väljas för framtida distributioner.
Om du vill inaktivera regionrekommendationsmeddelanden använder du cmdleten Update-AzConfig med parametern DisplayRegionIdentified , som du ser i följande exempel.
Update-AzConfig -DisplayRegionIdentified $false
Mer information om Azure-regioner finns i Välj rätt Azure-region åt dig.
Varning om att visa hemligheter
Azure PowerShell visar som standard ett varningsmeddelande som börjar med version 12.0.0 som hjälper dig att skydda känslig information när den identifierar en potentiell hemlighet i utdata från ett kommando.
I följande exempel används cmdleten Update-AzConfig för att inaktivera varningsmeddelandet.
Update-AzConfig -DisplaySecretsWarning $false
Undersökningar
När du använder Azure PowerShell kan du bli inbjuden att delta i en undersökning för att berätta om din upplevelse. Vi uppskattar de insikter som dessa data ger, men vi förstår att inte alla vill uppmanas att slutföra en undersökning.
Du kan inaktivera att uppmanas att delta i undersökningar med cmdleten Update-AzConfig , som du ser i följande exempel.
Update-AzConfig -DisplaySurveyMessage $false
Datainsamling
Som standard skickar Azure PowerShell-cmdletar telemetridata till Microsoft för att förbättra kundupplevelsen. Mer information finns i vår sekretesspolicy: aka.ms/privacy.
Update-AzConfig -EnableDataCollection $false
Felposter
Som standard skrivs Azure PowerShell-felposter till $HOME/.Azure/ErrorRecords.
Om du vill inaktivera beständiga felposter använder du cmdleten Update-AzConfig med parametern EnableErrorRecordsPersistence , som du ser i följande exempel.
Update-AzConfig -EnableErrorRecordsPersistence $false
Web Account Manager (WAM)
Från och med Az PowerShell-modul version 12.0.0 använder Windows-system webkontohanteraren (WAM) och Linux- och macOS-system använder webbläsarbaserad inloggning som standard.
Om du vill använda webbläsarbaserad inloggning i Windows 10 och senare eller på Windows Server 2019 och senare med Az 12.0.0 och senare måste du inaktivera WAM för användning med Azure PowerShell. Använd följande kommando för att inaktivera WAM och återgå till webbläsarbaserad inloggning, standardvärdet före Az 12.0.0.
Update-AzConfig -EnableLoginByWam $false
Den nya inloggningsupplevelsen
Från och med Az PowerShell-modul version 12.0.0 uppmanas du att välja en Azure-prenumeration att logga in med om du har åtkomst till flera prenumerationer.
När den nya inloggningsupplevelsen är inaktiverad och du har åtkomst till flera prenumerationer loggas du in på den första prenumerationen som Azure returnerar om du inte anger en prenumeration med Connect-AzAccount. Kommandon körs mot den här prenumerationen som standard. Det här beteendet kan vara farligt, till exempel om den första prenumerationen som returneras är en produktionsmiljö.
Om du vill inaktivera den nya inloggningsupplevelsen använder du cmdleten Update-AzConfig , som du ser i följande exempel.
Update-AzConfig -LoginExperienceV2 Off
Replikeringsinställningar
Om du vill replikera inställningarna från en miljö till en annan använder du cmdleten Export-AzConfig för att exportera inställningarna till en JSON-fil.
Export-AzConfig -Path $HOME\AzConfig.json
Om du vill importera inställningarna använder du cmdleten Import-AzConfig och refererar till den tidigare exporterade JSON-filen.
Import-AzConfig -Path $HOME\AzConfig.json
Rensa konfiguration
Om du vill återställa konfigurationsinställningen för en eller flera globala Azure PowerShell-inställningar till standardinställningen använder du cmdleten Clear-AzConfig . I följande exempel rensas inställningen DefaultSubscriptionForLogin .
Clear-AzConfig -DefaultSubscriptionForLogin