Delen via


Globale instellingen voor Azure PowerShell configureren

Azure PowerShell biedt verschillende algemene instellingen, zoals de optie voor het uitschakelen van waarschuwingsberichten voor wijziging die fouten veroorzaken. Vóór versie 9 van de Az PowerShell-module was er geen gecentraliseerde of gedetailleerde methode voor het configureren van deze globale instellingen.

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 van kracht zijn binnen een bepaald bereik. De geldige waarden voor de parameter Bereik zijn:

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

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

Configuratieopties

Er zijn talloze configuratieopties die u kunt instellen met de *-AzConfig cmdlets. Veel van deze configuratieopties worden in deze sectie weergegeven. Voer de volgende opdracht uit om een volledige lijst met de Azure PowerShell-configuratieopties weer te geven die u met de *-AzConfig cmdlets kunt instellen.

Get-AzConfig | Format-List

Upgrademeldingen

Meldingen in hulpprogramma's voor upgrades van Azure PowerShell-versies 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

Standaardabonnement

Vanaf Az PowerShell-moduleversie 12.0.0, als u toegang hebt tot meerdere abonnementen, wordt u standaard gevraagd om een Azure-abonnement te selecteren waarmee u zich wilt aanmelden.

Als u wilt voorkomen dat u telkens wanneer u zich interactief aanmeldt een abonnement wilt selecteren, gebruikt u de Update-AzConfig cmdlet met de parameter DefaultSubscriptionForLogin om uw standaardabonnement in te stellen, 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.

Exemplaardetectie

De instelling voor het detecteren van exemplaren is ontworpen voor situaties waarin het metagegevenseindpunt niet toegankelijk is, zoals in privéclouds of Azure Stack-omgevingen. Instantiedetectie omvat het ophalen van metagegevens van de instantie om https://login.microsoft.com/ de instantie te valideren. Door deze instelling in te schakelen (instellen op true), schakelt u zowel de detectie van exemplaren als de validatie van de instantie uit. Daarom is het essentieel om ervoor te zorgen dat de geconfigureerde instantiehost geldig en betrouwbaar is.

Als u zowel de detectie van exemplaren als de validatie van de instantie wilt uitschakelen, schakelt u deze instelling in (stelt u deze in op true).

Update-AzConfig -DisableInstanceDiscovery $true

Waarschuwingsberichten voor wijziging die fouten veroorzaken

Als u waarschuwingsberichten voor belangrijke wijzigingen voor cmdlets in alle Az-modules wilt uitschakelen, gebruikt u de Update-AzConfig cmdlet met de DisplayBreakingChangeWarning parameter, zoals wordt weergegeven in het volgende voorbeeld:

Update-AzConfig -DisplayBreakingChangeWarning $false

Als u het waarschuwingsbericht voor belangrijke wijzigingen specifiek wilt uitschakelen voor cmdlets in de Az.Compute-module , gebruikt u de Update-AzConfig cmdlet met zowel de parameters DisplayBreakingChangeWarning als 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.

Identificatie van Azure-regio's

Azure-klanten kunnen ervoor kiezen om resources in verschillende regio's te implementeren. Soms kunnen klanten 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 gekozen voor toekomstige implementaties.

Als u de berichten over regioaanmeldingen wilt uitschakelen, gebruikt u de Update-AzConfig cmdlet met de parameter DisplayRegionIdentified , zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -DisplayRegionIdentified $false

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

Waarschuwing voor geheimen weergeven

Azure PowerShell geeft standaard een waarschuwingsbericht weer vanaf versie 12.0.0 om gevoelige informatie te beveiligen wanneer er een potentieel geheim wordt geïdentificeerd in de uitvoer van een opdracht.

In het volgende voorbeeld wordt de Update-AzConfig cmdlet gebruikt om het waarschuwingsbericht uit te schakelen.

Update-AzConfig -DisplaySecretsWarning $false

Onderzoeken

Wanneer u Azure PowerShell gebruikt, wordt u mogelijk uitgenodigd om deel te nemen aan een enquête om ons te vertellen over uw ervaring. Hoewel we de inzichten die deze gegevens bieden waarderen, begrijpen we niet dat iedereen wordt gevraagd om een enquête te voltooien.

U kunt de vraag om deel te nemen aan enquêtes uitschakelen met de Update-AzConfig cmdlet, zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -DisplaySurveyMessage $false

Gegevens verzamelen

Standaard verzenden Azure PowerShell-cmdlets telemetriegegevens naar Microsoft om de klantervaring te verbeteren. Zie onze privacyverklaring: aka.ms/privacy voor meer informatie.

Update-AzConfig -EnableDataCollection $false

Foutrecords

Standaard worden Azure PowerShell-foutrecords naar $HOME/.Azure/ErrorRecordsgeschreven.

Als u permanente foutrecords wilt uitschakelen, gebruikt u de Update-AzConfig cmdlet met de parameter EnableErrorRecordsPersistence , zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -EnableErrorRecordsPersistence $false

Web Account Manager (WAM)

Vanaf Az PowerShell-moduleversie 12.0.0 maken Windows-systemen gebruik van Web Account Manager (WAM) en linux- en macOS-systemen maken standaard gebruik van browsergebaseerde aanmelding.

Als u aanmelding via een browser wilt gebruiken in Windows 10 en hoger of op Windows Server 2019 en hoger met Az 12.0.0 en hoger, moet u WAM uitschakelen voor gebruik met Azure PowerShell. Gebruik de volgende opdracht om WAM uit te schakelen en terug te keren naar aanmelding op basis van een browser, de standaardwaarde vóór Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

De nieuwe aanmeldingservaring

Vanaf Az PowerShell-moduleversie 12.0.0, als u toegang hebt tot meerdere abonnementen, wordt u gevraagd om een Azure-abonnement te selecteren waarmee u zich wilt aanmelden.

Wanneer de nieuwe aanmeldingservaring is uitgeschakeld en u toegang hebt tot meerdere abonnementen, wordt u aangemeld bij het eerste abonnement dat Azure retourneert, tenzij u een abonnement opgeeft met Connect-AzAccount. Opdrachten worden standaard uitgevoerd voor dit abonnement. Dit gedrag kan gevaarlijk zijn, bijvoorbeeld als het eerste geretourneerde abonnement een productieomgeving is.

Als u de nieuwe aanmeldingservaring wilt uitschakelen, gebruikt u de Update-AzConfig cmdlet, zoals wordt weergegeven in het volgende voorbeeld.

Update-AzConfig -LoginExperienceV2 Off

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