Globale instellingen voor Azure PowerShell configureren

  • Artikel

Azure PowerShell ondersteunt verschillende algemene instellingen, zoals het uitschakelen van waarschuwingsberichten voor wijziging die fouten veroorzaken. Vóór Az PowerShell-module versie 9 was er geen gecentraliseerde of gedetailleerde manier om globale instellingen voor Azure PowerShell te configureren.

Gecentraliseerde configuratie

De Az PowerShell-module versie 9 en hoger bevat cmdlets voor het beheren van de configuratie van globale instellingen voor Azure PowerShell. Deze *-AzConfig cmdlets maken deel uit van de PowerShell-module Az.Accounts:

Gedetailleerde instellingen

U kunt instellingen toepassen die alleen van kracht zijn in een bepaald bereik. De geldige waarden voor de parameter Bereik zijn:

  • Current User. De standaardinstelling bij het toepassen van een instelling.
  • Process. De instelling wordt alleen toegepast op de huidige PowerShell-sessie.
  • Default. Alleen-lezen bereik waarbij de standaardwaarde niet is gewijzigd.
  • Environment. Alleen-lezen bereik waarbij de waarde is geconfigureerd via een omgevingsvariabele.

Naast bereiken kunt u de instellingen toepassen op alle Az PowerShell-modules of slechts één module. Met de parameter AppliesTo kunt u opgeven hoe breed u de instelling wilt toepassen. De waarde Az geeft aan dat de instelling wordt toegepast op alle beschikbare modules die deel uitmaken van Azure PowerShell.

Als u het waarschuwingsbericht voor belangrijke wijzigingen voor cmdlets in de Az.Compute-module wilt uitschakelen, gebruikt u de Update-AzConfig cmdlet met de parameters DisplayBreakingChangeWarning en AppliesTo , zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

In dit scenario blijft het waarschuwingsbericht voor belangrijke wijzigingen actief voor cmdlets in alle Az PowerShell-modules, met uitzondering van Az.Compute.

Standaardabonnement

Wanneer u zich bij Azure verifieert, worden standaard alle abonnementen opgehaald waartoe u toegang hebt. Het eerste abonnement dat door Azure wordt geretourneerd, wordt gebruikt, tenzij u een abonnement opgeeft met Connect-AzAccount. Dit gedrag kan gevaarlijk zijn, bijvoorbeeld als het eerste geretourneerde abonnement een productieomgeving is.

Als u uw standaardabonnement wilt configureren, gebruikt u de Update-AzConfig cmdlet met de parameter DefaultSubscriptionForLogin , zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Notitie

Niet te verwarren met het abonnement van de standaardcontext, wordt de DefaultSubscriptionForLogin-configuratie alleen van kracht bij het verifiëren bij Azure.

Upgrademeldingen

In-toolmeldingen voor versie-upgrades van Azure PowerShell is een functie die is uitgebracht in Az PowerShell-module versie 10.3.0. Wanneer er een nieuwe versie van Azure PowerShell beschikbaar is, wordt er een upgrademelding weergegeven in uw interactieve PowerShell-sessie.

Als u wilt bepalen of upgrademeldingen zijn ingeschakeld, gebruikt u de Get-AzConfig cmdlet met de parameter CheckForUpgrade , zoals wordt weergegeven in het volgende voorbeeld.

Get-AzConfig -CheckForUpgrade

Als u upgrademeldingen voor Azure PowerShell wilt inschakelen, gebruikt u de Update-AzConfig cmdlet met de parameter CheckForUpgrade en $true voor de waarde, zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -CheckForUpgrade $true

Als u upgrademeldingen wilt uitschakelen, gebruikt u de Update-AzConfig cmdlet met de parameter CheckForUpgrade en $false voor de waarde, zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -CheckForUpgrade $false

Identificatie van Azure-regio's

Azure-klanten kunnen ervoor kiezen om resources in veel verschillende regio's te implementeren. In sommige gevallen kunnen klanten de kosten verlagen door regio's in de buurt te selecteren die dezelfde services aanbieden. Als er een regio in de buurt wordt geïdentificeerd, wordt in een bericht de regio weergegeven die moet worden geselecteerd voor toekomstige implementaties.

Aanbevelingsbericht regio uitschakelen

In het volgende voorbeeld wordt de Update-AzConfig cmdlet gebruikt om het bericht over de regioaanmelding uit te schakelen:

Update-AzConfig -DisplayRegionIdentified $false

Zie de juiste Azure-regio voor u kiezen voor meer informatie over Azure-regio's.

Instellingen repliceren

Als u uw instellingen van de ene omgeving naar de andere wilt repliceren, gebruikt u de Export-AzConfig cmdlet om de instellingen te exporteren naar een JSON-bestand.

Export-AzConfig -Path $HOME\AzConfig.json

Als u uw instellingen wilt importeren, gebruikt u de Import-AzConfig cmdlet en verwijst u naar het eerder geëxporteerde JSON-bestand.

Import-AzConfig -Path $HOME\AzConfig.json

Configuratie wissen

Gebruik de cmdlet om de configuratie-instelling van een of meer globale instellingen van Azure PowerShell opnieuw in te stellen op de Clear-AzConfig standaardinstelling. In het volgende voorbeeld wordt de instelling DefaultSubscriptionForLogin gewist.

Clear-AzConfig -DefaultSubscriptionForLogin