Konfigurera globala Azure PowerShell-inställningar

  • Artikel

Azure PowerShell stöder flera globala inställningar som att inaktivera varningsmeddelanden om icke-bakåtkompatibla ändringar. Innan Az PowerShell-modul version 9 fanns det inget centraliserat eller detaljerat sätt att konfigurera globala inställningar för Azure PowerShell.

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 endast gäller i ett visst omfång. Giltiga värden för parametern Omfång är:

  • Current User. Standardvärdet när du tillämpar en inställning.
  • Process. Inställningen tillämpas endast på den aktuella PowerShell-sessionen.
  • Default. Skrivskyddat omfång där standardvärdet inte har ändrats.
  • Environment. Skrivskyddat omfång där värdet har konfigurerats via en miljövariabel.

Förutom omfång kan du använda inställningarna 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 tillgängliga moduler som ingår i Azure PowerShell.

Om du vill inaktivera varningsmeddelandet om icke-bakåtkompatibel ändring 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.

Standardprenumeration

När du autentiserar till Azure hämtas som standard alla prenumerationer som du kan komma åt. Den första prenumerationen som returneras av Azure används om du inte anger en prenumeration med Connect-AzAccount. Det här beteendet kan vara farligt, till exempel om den första prenumerationen som returneras är en produktionsmiljö.

Om du vill konfigurera din standardprenumeration använder du cmdleten Update-AzConfig med parametern DefaultSubscriptionForLogin enligt 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.

Uppgradera meddelanden

Meddelanden i verktyget för versionsuppgraderingar av Azure PowerShell ä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

Identifiering av Azure-region

Azure-kunder kan välja att distribuera resurser i många olika regioner. I vissa fall 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.

Meddelande om att inaktivera regionrekommendationsmeddelande

I följande exempel används cmdleten Update-AzConfig för att inaktivera regionrekommendationsmeddelandet:

Update-AzConfig -DisplayRegionIdentified $false

Mer information om Azure-regioner finns i välja rätt Azure-region åt dig.

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