Az Azure PowerShell globális beállításainak konfigurálása

Az Azure PowerShell különböző globális beállításokat kínál, például letilthatja a kompatibilitástörő változásra figyelmeztető üzeneteket. Az Az PowerShell-modul 9-es verziója előtt nem volt központosított vagy részletes módszer ezeknek a globális beállításoknak a konfigurálására.

Központosított konfiguráció

Az Az PowerShell-modul 9-es és újabb verziója parancsmagokat tartalmaz az Azure PowerShell globális beállításainak konfigurálásának kezeléséhez. Ezek a *-AzConfig parancsmagok az Az.Accounts PowerShell-modul részét képezik:

• Get-AzConfig
• Update-AzConfig
• Export-AzConfig
• Import-AzConfig
• Clear-AzConfig

Részletes beállítások

Alkalmazhat olyan beállításokat, amelyek egy adott hatókörön belül érvényesek. A Hatókör paraméter érvényes értékei a következők:

• Current User: Beállítás alkalmazásakor az alapértelmezett hatókör.
• Process: A beállítás csak az aktuális PowerShell-munkamenetre van alkalmazva.
• Default: Írásvédett hatókör, ahol az alapértelmezett érték nem változott.
• Environment: Írásvédett hatókör, ahol az érték környezeti változón keresztül van konfigurálva.

A hatókörök mellett az összes Az PowerShell-modulra vagy csak egyetlen modulra is alkalmazhat beállításokat. Az AppliesTo paraméterrel megadhatja, hogy milyen széles körben szeretné alkalmazni a beállítást. Az érték Az azt jelzi, hogy a beállítás az Azure PowerShell részét képező összes modulra vonatkozik.

Konfigurációs lehetőségek

A parancsmagokkal *-AzConfig számos konfigurációs beállítás állítható be. Ezen konfigurációs beállítások közül sok jelenik meg ebben a szakaszban. Futtassa az alábbi parancsot a parancsmagokkal *-AzConfig megadható Azure PowerShell-konfigurációs beállítások teljes listájának megtekintéséhez.

Get-AzConfig | Format-List

Frissítési értesítések

Az Azure PowerShell verziófrissítéseinek eszközbeli értesítései az Az PowerShell-modul 10.3.0-s verziójában megjelent szolgáltatás. Ha elérhető az Azure PowerShell új verziója, egy frissítési értesítés jelenik meg az interaktív PowerShell-munkamenetben.

Annak megállapításához, hogy engedélyezve vannak-e a frissítési értesítések, használja a Get-AzConfig parancsmagot a CheckForUpgrade paraméterrel, ahogyan az az alábbi példában látható.

Get-AzConfig -CheckForUpgrade

Az Azure PowerShell frissítési értesítéseinek engedélyezéséhez használja a Update-AzConfig parancsmagot a CheckForUpgrade paraméterrel és $true annak értékével, az alábbi példában látható módon.

Update-AzConfig -CheckForUpgrade $true

A frissítési értesítések kikapcsolásához használja a Update-AzConfig parancsmagot a CheckForUpgrade paraméterrel és $false annak értékével, az alábbi példában látható módon.

Update-AzConfig -CheckForUpgrade $false

Alapértelmezett előfizetés

Alapértelmezés szerint az Az PowerShell-modul 12.0.0-s verziójától kezdve, ha több előfizetéshez is hozzáfér, a rendszer kérni fogja, hogy válasszon ki egy Azure-előfizetést, amellyel bejelentkezhet.

Ha meg szeretné akadályozni, hogy a rendszer minden alkalommal, amikor interaktív módon bejelentkezik, válassza ki az előfizetést, használja a Update-AzConfig DefaultSubscriptionForLogin paraméterrel rendelkező parancsmagot az alapértelmezett előfizetés beállításához, ahogyan az az alábbi példában is látható.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Feljegyzés

Nem tévesztendő össze az alapértelmezett környezet előfizetésével, a DefaultSubscriptionForLogin konfiguráció csak az Azure-ba való hitelesítéskor lép érvénybe.

Példányfelderítés

A letiltott példányfelderítési beállítás olyan helyzetekre lett kialakítva, amikor a metaadat-végpont nem érhető el, például magánfelhőkben vagy Azure Stack-környezetekben. A példányfelderítés magában foglalja a szolgáltató metaadatainak https://login.microsoft.com/ lekérését a szolgáltató ellenőrzéséhez. A beállítás engedélyezésével (a beállítás beállításával true) letilthatja a példányfelderítést és a hitelesítést is. Ezért elengedhetetlen annak biztosítása, hogy a konfigurált szolgáltatói gazdagép érvényes és megbízható legyen.

A példányfelderítés és a hitelesítés letiltásához engedélyezze ezt a beállítást (állítsa be a következőre true).

Update-AzConfig -DisableInstanceDiscovery $true

Kompatibilitástörő változásra figyelmeztető üzenetek

Ha le szeretné tiltani a kompatibilitástörő változásra figyelmeztető üzeneteket az összes Az-modul parancsmagjaihoz, használja a Update-AzConfig parancsmagot a DisplayBreakingChangeWarning paraméterrel, ahogyan az az alábbi példában látható:

Update-AzConfig -DisplayBreakingChangeWarning $false

Ha le szeretné tiltani a kifejezetten az Az.Compute modul parancsmagjaira vonatkozó kompatibilitástörő változásra figyelmeztető üzenetet, használja a Update-AzConfig parancsmagot a DisplayBreakingChangeWarning és az AppliesTo paraméterekkel is, ahogyan az az alábbi példában látható:

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

Ebben a forgatókönyvben a kompatibilitástörő változásra figyelmeztető üzenet az Az.Compute kivételével minden Az PowerShell-modulban aktív marad.

Azure-régióazonosítás

Az Azure-ügyfelek több különböző régióban is üzembe helyezhetnek erőforrásokat. Előfordulhat, hogy az ügyfelek csökkenthetik a költségeket az azonos szolgáltatásokat kínáló közeli régiók kiválasztásával. Ha egy közeli régiót azonosít, egy üzenet megjeleníti a jövőbeli üzembe helyezéshez kiválasztandó régiót.

A régiójavaslatok üzeneteinek letiltásához használja a Update-AzConfig parancsmagot a DisplayRegionIdentified paraméterrel, ahogyan az az alábbi példában látható.

Update-AzConfig -DisplayRegionIdentified $false

Az Azure-régiókról további információt a megfelelő Azure-régió kiválasztása című témakörben talál.

Titkos kódok megjelenítése figyelmeztetés

Az Azure PowerShell alapértelmezés szerint a 12.0.0-s verziótól kezdődően figyelmeztető üzenetet jelenít meg, amely segít megvédeni a bizalmas adatokat, ha egy parancs kimenetében egy lehetséges titkos kulcsot azonosít.

Az alábbi példában a Update-AzConfig parancsmag használatával tiltja le a figyelmeztető üzenetet.

Update-AzConfig -DisplaySecretsWarning $false

Felmérések

Az Azure PowerShell használatakor előfordulhat, hogy felkérjük, hogy vegyen részt egy felmérésben, hogy megismerje a tapasztalatait. Bár nagyra értékeljük az adatok által nyújtott megállapításokat, megértjük, hogy nem mindenki szeretné, hogy a rendszer kérje a felmérés elvégzését.

A következő példában látható módon letilthatja a felmérésekben való részvételre való felkérést a Update-AzConfig parancsmaggal.

Update-AzConfig -DisplaySurveyMessage $false

Adatgyűjtés

Az Azure PowerShell-parancsmagok alapértelmezés szerint telemetriai adatokat küldenek a Microsoftnak az ügyfélélmény javítása érdekében. További információkért lásd adatvédelmi nyilatkozatunkat: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Hibarekordok

Alapértelmezés szerint az Azure PowerShell-hibarekordok a következőbe $HOME/.Azure/ErrorRecordsvannak írva: .

Az állandó hibarekordok letiltásához használja a Update-AzConfig parancsmagot az EnableErrorRecordsPersistence paraméterrel, az alábbi példában látható módon.

Update-AzConfig -EnableErrorRecordsPersistence $false

Web Account Manager (WAM)

Az Az PowerShell-modul 12.0.0-s verziójától kezdve a Windows-rendszerek a Web Account Managert (WAM) használják, a Linux és macOS rendszerek pedig alapértelmezés szerint böngészőalapú bejelentkezést használnak.

Ha böngészőalapú bejelentkezést szeretne használni a Windows 10-en és újabb verziókon, illetve a Windows Server 2019-en és újabb verziókban az Az 12.0.0-s és újabb verzióival, le kell tiltania a WAM-ot az Azure PowerShell-lel való használathoz. Az alábbi paranccsal tiltsa le a WAM-ot, és térjen vissza a böngészőalapú bejelentkezéshez, amely az alapértelmezett az Az 12.0.0 előtt.

Update-AzConfig -EnableLoginByWam $false

Az új bejelentkezési felület

Az Az PowerShell-modul 12.0.0-s verziójától kezdve, ha több előfizetéshez is hozzáfér, a rendszer kérni fogja, hogy válasszon ki egy Azure-előfizetést, amellyel bejelentkezhet.

Ha az új bejelentkezési felület le van tiltva, és több előfizetéshez is hozzáférése van, akkor az Első Azure-előfizetésbe jelentkezik be, hacsak nem ad meg egy előfizetést Connect-AzAccount. A parancsok alapértelmezés szerint ezen az előfizetésen futnak. Ez a viselkedés veszélyes lehet, például ha az első visszaadott előfizetés éles környezet.

Az új bejelentkezési felület letiltásához használja a Update-AzConfig parancsmagot az alábbi példában látható módon.

Update-AzConfig -LoginExperienceV2 Off

Replikálási beállítások

A beállítások egyik környezetből a másikba való replikálásához a Export-AzConfig parancsmaggal exportálja a beállításokat egy JSON-fájlba.

Export-AzConfig -Path $HOME\AzConfig.json

A beállítások importálásához használja a Import-AzConfig parancsmagot, és hivatkozzon a korábban exportált JSON-fájlra.

Import-AzConfig -Path $HOME\AzConfig.json

Konfiguráció törlése

Egy vagy több Globális Azure PowerShell-beállítás alapértelmezettre állításához használja a Clear-AzConfig parancsmagot. Az alábbi példában a DefaultSubscriptionForLogin beállítás törlődik.

Clear-AzConfig -DefaultSubscriptionForLogin