Megosztás a következőn keresztül:

Virtuális gépi bővítmények és szolgáltatások Windows rendszeren

  • Cikk

Az Azure virtuálisgép-bővítmények olyan kisméretű alkalmazások, amelyek üzembe helyezés utáni konfigurációs és automatizálási feladatokat biztosítanak az Azure-beli virtuális gépeken. Ha például egy virtuális géphez szoftvertelepítésre, víruskereső védelemre vagy szkript futtatására van szükség a virtuális gépen belül, használhat egy virtuálisgép-bővítményt.

Azure-beli virtuálisgép-bővítményeket az Azure CLI, a PowerShell, az Azure Resource Manager (ARM) sablonok és az Azure Portal használatával futtathat. A bővítményeket kötegelheti egy új virtuálisgép-üzembe helyezéssel, vagy futtathatja őket bármely meglévő rendszeren.

Ez a cikk áttekintést nyújt az Azure-beli virtuálisgép-bővítményekről, beleértve a bővítmények észlelésére, kezelésére és eltávolítására vonatkozó előfeltételeket és útmutatást. Ez a cikk általános információkat tartalmaz, mivel számos virtuálisgép-bővítmény érhető el. Minden bővítmény egyedi konfigurációval és saját dokumentációval rendelkezik.

Használati esetek és minták

Minden Azure-beli virtuálisgép-bővítménynek van egy adott használati esete. Íme néhány példa:

  • A Kívánt PowerShell-állapotkonfigurációk (DSC-k) alkalmazása egy virtuális gépre a Windows DSC-bővítményével.

  • Konfigurálja a virtuális gépek monitorozását az Azure Monitor-ügynök és a virtuálisgép-elemzések használatával.

  • Azure-beli virtuális gép konfigurálása a Chef használatával.

  • Konfigurálja az Azure-infrastruktúra monitorozását a Datadog bővítmény használatával.

A folyamatspecifikus bővítmények mellett egyéni szkriptbővítmény is elérhető Windows és Linux rendszerű virtuális gépeken. A Windows egyéni szkriptbővítményével bármely PowerShell-szkript futtatható virtuális gépen. Az egyéni szkriptek olyan Azure-üzemelő példányok tervezéséhez hasznosak, amelyek a natív Azure-eszközhasználaton túl konfigurálást igényelnek.

Előfeltételek

Tekintse át az Alábbi előfeltételeket az Azure-beli virtuálisgép-bővítmények használatához.

Azure-beli virtuálisgép-ügynök

A virtuális gépen lévő bővítmények kezeléséhez telepítve kell lennie a Windowshoz készült Azure Virtual Machine Agentnek. Ezt az ügynököt azure-beli virtuálisgép-ügynöknek vagy Windows-vendégügynöknek is nevezik. A bővítmények telepítésének előkészítése során vegye figyelembe, hogy egyes bővítmények egyéni előfeltételekkel rendelkeznek, például az erőforrásokhoz vagy függőségekhez való hozzáféréssel.

Az Azure-beli virtuálisgép-ügynök kezeli az Azure-beli virtuális gépek és az Azure Fabric-vezérlő közötti interakciókat. Az ügynök az Azure-beli virtuális gépek üzembe helyezésének és kezelésének számos funkcionális aspektusáért felelős, beleértve a virtuálisgép-bővítmények futtatását is.

Az Azure-beli virtuálisgép-ügynök előre telepítve van az Azure Marketplace-rendszerképeken. Az ügynök manuálisan is telepíthető a támogatott operációs rendszerekre.

Az ügynök több operációs rendszeren fut. A bővítmények keretrendszere azonban korlátozza a bővítmények által használt operációs rendszereket. Egyes bővítmények nem támogatottak az összes operációs rendszeren, és az 51-ös hibakódot ("nem támogatott operációs rendszer") is kibocsáthatják. A támogatottságért tekintse meg az egyes bővítmények dokumentációját.

Hálózati hozzáférés

A bővítménycsomagok az Azure Storage-bővítménytárházból töltődnek le. A bővítmény állapotfeltöltései az Azure Storage-ba kerülnek.

Ha az Azure-beli virtuálisgép-ügynök támogatott verzióját használja, nem kell engedélyeznie az Azure Storage elérését a virtuálisgép-régióban. A virtuálisgép-ügynökkel átirányíthatja a kommunikációt az Azure Fabric-vezérlőbe ügynökkommunikáció céljából (a szolgáltatáson keresztül a HostGAPlugin 168.63.129.16-os magánhálózati IP-cím kiemelt csatornáján keresztül). Ha a virtuálisgép-ügynök nem támogatott verzióján dolgozik, engedélyeznie kell az Azure Storage-hoz való kimenő hozzáférést az adott régióban a virtuális gépről.

Fontos

Ha letiltja a 168.63.129.16 IP-címhez való hozzáférést a vendég tűzfallal vagy proxyn keresztül, a bővítmények sikertelenek lesznek. A hiba akkor is előfordul, ha a virtuálisgép-ügynök támogatott verzióját használja, vagy kimenő hozzáférést konfigurál. A 80-s és a 32526-os portra van szükség.

Az ügynökök csak bővítménycsomagok és jelentésállapotok letöltésére használhatók. Ha például egy bővítménytelepítésnek le kell töltenie egy szkriptet a GitHubról (egyéni szkriptbővítmény), vagy hozzáférést igényel az Azure Storage-hoz (Azure Backup), akkor más tűzfal- vagy hálózati biztonsági csoport (NSG) portokat kell megnyitnia. A különböző bővítmények eltérő követelményekkel rendelkeznek, mivel saját jogon használhatók. Az Azure Storage-hoz vagy a Microsoft Entra-azonosítóhoz hozzáférést igénylő bővítmények esetében az Azure NSG szolgáltatáscímkék használatával engedélyezheti a hozzáférést.

Az Azure-beli virtuálisgép-ügynök nem nyújt proxykiszolgálói támogatást az ügynökforgalmi kérelmek átirányításának engedélyezéséhez. A virtuálisgép-ügynök az egyéni proxyra támaszkodik (ha van ilyen), hogy az erőforrásokat az interneten vagy a gazdagépen a 168.63.129.16 IP-címen keresztül érje el.

Virtuálisgép-bővítmények felfedezése

Számos virtuálisgép-bővítmény érhető el az Azure-beli virtuális gépekhez. A teljes lista megtekintéséhez használja a Get-AzVMExtensionImage PowerShell-parancsmagot.

Az alábbi parancs az USA nyugati régiójában elérhető összes virtuálisgép-bővítményt felsorolja:

Get-AzVmImagePublisher -Location "West US" |
Get-AzVMExtensionImageType |
Get-AzVMExtensionImage | Select Type, Version

Ez a parancs a következő példához hasonló kimenetet biztosít:

Type                Version
----                -------
AcronisBackup       1.0.33
AcronisBackup       1.0.51
AcronisBackupLinux  1.0.33
AlertLogicLM        1.3.0.1
AlertLogicLM        1.3.0.0
AlertLogicLM        1.4.0.1

Virtuálisgép-bővítmények futtatása

Az Azure-beli virtuálisgép-bővítmények meglévő virtuális gépeken futnak, ami akkor hasznos, ha konfigurációs módosításokat kell végeznie, vagy helyreállítania kell a kapcsolatot egy már üzembe helyezett virtuális gépen. A virtuálisgép-bővítmények ARM-sablontelepítésekkel is csomagolhatók. Az ARM-sablonokkal rendelkező bővítmények használatával üzembe helyezhet és konfigurálhat Azure-beli virtuális gépeket az üzembe helyezés utáni beavatkozás nélkül.

A következő módszerekkel futtathat bővítményt egy meglévő virtuális gépen.

Feljegyzés

Az alábbi példák közül néhány paraméterértékeket használ "<placeholder>" a parancsokban. Az egyes parancsok futtatása előtt mindenképpen cserélje le az értékeket "<placeholder>" a konfigurációhoz megadott értékekre.

PowerShell

Számos PowerShell-parancs létezik az egyes bővítmények futtatásához. Lista megtekintéséhez használja a Get-Command parancsot, és szűrjön a bővítményre:

Get-Command Set-Az*Extension* -Module Az.Compute

Ez a parancs a következő példához hasonló kimenetet biztosít:

CommandType     Name                                          Version    Source
-----------     ----                                          -------    ------
Cmdlet          Set-AzVMAccessExtension                       4.5.0      Az.Compute
Cmdlet          Set-AzVMADDomainExtension                     4.5.0      Az.Compute
Cmdlet          Set-AzVMAEMExtension                          4.5.0      Az.Compute
Cmdlet          Set-AzVMBackupExtension                       4.5.0      Az.Compute
Cmdlet          Set-AzVMBginfoExtension                       4.5.0      Az.Compute
Cmdlet          Set-AzVMChefExtension                         4.5.0      Az.Compute
Cmdlet          Set-AzVMCustomScriptExtension                 4.5.0      Az.Compute
Cmdlet          Set-AzVMDiagnosticsExtension                  4.5.0      Az.Compute
Cmdlet          Set-AzVMDiskEncryptionExtension               4.5.0      Az.Compute
Cmdlet          Set-AzVMDscExtension                          4.5.0      Az.Compute
Cmdlet          Set-AzVMExtension                             4.5.0      Az.Compute
Cmdlet          Set-AzVMSqlServerExtension                    4.5.0      Az.Compute
Cmdlet          Set-AzVmssDiskEncryptionExtension             4.5.0      Az.Compute

Az alábbi példa az Egyéni szkriptbővítménnyel tölt le egy szkriptet egy GitHub-adattárból a cél virtuális gépre, majd futtatja a szkriptet.

Set-AzVMCustomScriptExtension -ResourceGroupName "<myResourceGroup>" `
    -VMName "<myVM>" -Name "<myCustomScript>" `
    -FileUri "https://raw.githubusercontent.com/neilpeterson/nepeters-azure-templates/master/windows-custom-script-simple/support-scripts/Create-File.ps1" `
    -Run "Create-File.ps1" -Location "<myVMregion>"

Az alábbi példa a VMAccess bővítményt használja egy Windows rendszerű virtuális gép rendszergazdai jelszavának ideiglenes jelszóra való visszaállításához. A kód futtatása után az első bejelentkezéskor alaphelyzetbe kell állítania a jelszót.

$cred=Get-Credential

Set-AzVMAccessExtension -ResourceGroupName "myResourceGroup" -VMName "myVM" -Name "myVMAccess" `
    -Location "myVMregion" -UserName $cred.GetNetworkCredential().Username `
    -Password $cred.GetNetworkCredential().Password -typeHandlerVersion "2.0"

A Set-AzVMExtension paranccsal bármilyen virtuálisgép-bővítményt elindíthat.

Azure Portal

Az Azure Portalon virtuálisgép-bővítményeket alkalmazhat egy meglévő virtuális gépre. Válassza ki a virtuális gépet a portálon, válassza a Bővítmények + Alkalmazások lehetőséget, majd a + Hozzáadás lehetőséget. Válassza ki a kívánt bővítményt az elérhető bővítmények listájából, és kövesse a varázsló utasításait.

Az alábbi példa a Microsoft Antimalware bővítmény Azure Portalról történő telepítését mutatja be:

Képernyőkép a Microsoft Antimalware bővítmény telepítésének párbeszédpaneljéről.

Azure Resource Manager-sablonok

Hozzáadhat virtuálisgép-bővítményeket egy ARM-sablonhoz, és futtathatja őket a sablon üzembe helyezésével. Amikor sablonnal üzembe helyez egy bővítményt, teljes mértékben konfigurált Azure-üzembe helyezéseket hozhat létre.

A következő JSON-példa egy ARM-sablonból származik, amely terheléselosztásos virtuális gépeket és Egy Azure SQL-adatbázist helyez üzembe, majd minden egyes virtuális gépen telepít egy .NET Core-alkalmazást. A virtuálisgép-bővítmény gondoskodik a szoftvertelepítésről.

{
    "apiVersion": "2015-06-15",
    "type": "extensions",
    "name": "config-app",
    "location": "[resourceGroup().location]",
    "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'),copyindex())]",
    "[variables('musicstoresqlName')]"
    ],
    "tags": {
    "displayName": "config-app"
    },
    "properties": {
    "publisher": "Microsoft.Compute",
    "type": "CustomScriptExtension",
    "typeHandlerVersion": "1.9",
    "autoUpgradeMinorVersion": true,
    "settings": {
        "fileUris": [
        "https://raw.githubusercontent.com/Microsoft/dotnet-core-sample-templates/master/dotnet-core-music-windows/scripts/configure-music-app.ps1"
        ]
    },
    "protectedSettings": {
        "commandToExecute": "[concat('powershell -ExecutionPolicy Unrestricted -File configure-music-app.ps1 -user ',parameters('adminUsername'),' -password ',parameters('adminPassword'),' -sqlserver ',variables('musicstoresqlName'),'.database.windows.net')]"
    }
    }
}

Az ARM-sablonok létrehozásáról további információt az ARM-sablon virtuális gépei című témakörben talál.

A virtuálisgép-bővítmény adatainak védelme

Virtuálisgép-bővítmény futtatásakor előfordulhat, hogy bizalmas információkat kell tartalmaznia, például hitelesítő adatokat, tárfiókneveket és hozzáférési kulcsokat. Számos virtuálisgép-bővítmény tartalmaz egy védett konfigurációt, amely titkosítja az adatokat, és csak a cél virtuális gépen belül fejti vissza azokat. Minden bővítmény egy adott védett konfigurációs sémával rendelkezik, és az egyes sémákat a bővítményspecifikus dokumentáció részletezi.

Az alábbi JSON-példa a Windows egyéni szkriptbővítményének egy példányát mutatja be. A futtatandó parancs hitelesítő adatok készletét tartalmazza. Ebben a példában a futtatandó parancs nincs titkosítva.

{
    "apiVersion": "2015-06-15",
    "type": "extensions",
    "name": "config-app",
    "location": "[resourceGroup().location]",
    "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'),copyindex())]",
    "[variables('musicstoresqlName')]"
    ],
    "tags": {
    "displayName": "config-app"
    },
    "properties": {
    "publisher": "Microsoft.Compute",
    "type": "CustomScriptExtension",
    "typeHandlerVersion": "1.9",
    "autoUpgradeMinorVersion": true,
    "settings": {
        "fileUris": [
        "https://raw.githubusercontent.com/Microsoft/dotnet-core-sample-templates/master/dotnet-core-music-windows/scripts/configure-music-app.ps1"
        ],
        "commandToExecute": "[concat('powershell -ExecutionPolicy Unrestricted -File configure-music-app.ps1 -user ',parameters('adminUsername'),' -password ',parameters('adminPassword'),' -sqlserver ',variables('musicstoresqlName'),'.database.windows.net')]"
    }
    }
}

A commandToExecute tulajdonság konfigurációba való protected áthelyezése segít a végrehajtási sztring biztonságossá tételében, ahogyan az az alábbi példában is látható:

{
    "apiVersion": "2015-06-15",
    "type": "extensions",
    "name": "config-app",
    "location": "[resourceGroup().location]",
    "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'),copyindex())]",
    "[variables('musicstoresqlName')]"
    ],
    "tags": {
    "displayName": "config-app"
    },
    "properties": {
    "publisher": "Microsoft.Compute",
    "type": "CustomScriptExtension",
    "typeHandlerVersion": "1.9",
    "autoUpgradeMinorVersion": true,
    "settings": {
        "fileUris": [
        "https://raw.githubusercontent.com/Microsoft/dotnet-core-sample-templates/master/dotnet-core-music-windows/scripts/configure-music-app.ps1"
        ]
    },
    "protectedSettings": {
        "commandToExecute": "[concat('powershell -ExecutionPolicy Unrestricted -File configure-music-app.ps1 -user ',parameters('adminUsername'),' -password ',parameters('adminPassword'),' -sqlserver ',variables('musicstoresqlName'),'.database.windows.net')]"
    }
    }
}

A bővítményeket használó Azure-infrastruktúra szolgáltatásként (IaaS) virtuális gépen a tanúsítványkonzolon olyan tanúsítványok jelenhetnek meg, amelyek rendelkeznek a Windows Azure CRP tanúsítványgenerátor tulajdonosával. Klasszikus RedDog Front End (RDFE) rendszerű virtuális gépeken ezek a tanúsítványok a Windows Azure Service Management for Extensions tulajdonosnevével rendelkeznek.

Ezek a tanúsítványok biztosítják a virtuális gép és a gazdagép közötti kommunikációt a bővítmények által használt védett beállítások (jelszó és egyéb hitelesítő adatok) átvitele során. Az Azure Fabric-vezérlő létrehozza a tanúsítványokat, és átadja őket az Azure-beli virtuálisgép-ügynöknek. Ha minden nap leállítja és elindítja a virtuális gépet, a hálóvezérlő létrehozhat egy új tanúsítványt. A tanúsítvány a számítógép személyes tanúsítványtárolójában van tárolva. Ezek a tanúsítványok törölhetők. Az Azure-beli virtuálisgép-ügynök szükség esetén újra létrehozza a tanúsítványokat.

Ügynökök és bővítmények frissítése

Az ügynökök és bővítmények ugyanazt az automatikus frissítési mechanizmust használják.

Ha elérhető egy frissítés, és az automatikus frissítések engedélyezve vannak, a frissítés csak egy bővítmény vagy más virtuálisgép-modell módosítása után lesz telepítve a virtuális gépre. A módosítások a következők lehetnek:

  • Adatlemezek
  • Bővítmények
  • Bővítménycímkék
  • Rendszerindítási diagnosztikai tároló
  • Vendég operációs rendszer titkos kódjai
  • Virtuális gép mérete
  • Hálózati profil

A közzétevők különböző időpontokban teszik elérhetővé a frissítéseket a régiók számára. Lehetséges, hogy különböző régiókban lévő virtuális gépek különböző verziókban vannak.

Feljegyzés

Egyes frissítések további tűzfalszabályokat igényelhetnek. További információ: Hálózati hozzáférés.

Virtuális gépen üzembe helyezett bővítmények listázása

A következő paranccsal listázhatja a virtuális gépen üzembe helyezett bővítményeket:

$vm = Get-AzVM -ResourceGroupName "<myResourceGroup>" -VMName "<myVM>"
$vm.Extensions | select Publisher, VirtualMachineExtensionType, TypeHandlerVersion

Ez a parancs az alábbi példához hasonló kimenetet hoz létre:

Publisher             VirtualMachineExtensionType          TypeHandlerVersion
---------             ---------------------------          ------------------
Microsoft.Compute     CustomScriptExtension                1.9

Ügynökfrissítések

Az Azure-beli virtuálisgép-ügynök csak bővítménykezelési kódot tartalmaz. A Windows kiépítési kódja külön van. Eltávolíthatja az Azure-beli virtuálisgép-ügynököt. Nem tilthatja le az Azure-beli virtuálisgép-ügynök automatikus frissítését.

A bővítménykezelési kód a következő feladatokért felelős:

  • Kommunikáció az Azure Fabricdel.
  • Kezelje a virtuálisgép-bővítmény műveleteit, például a telepítéseket, a jelentési állapotot, az egyes bővítmények frissítését és a bővítmények eltávolítását. A frissítések biztonsági javításokat, hibajavításokat és fejlesztéseket tartalmaznak a bővítménykezelő kódhoz.

A futtatott verzió ellenőrzéséhez tekintse meg az Azure-beli virtuálisgép-ügynök észlelését.

Bővítményfrissítések

Ha elérhető egy bővítményfrissítés, és engedélyezve vannak az automatikus frissítések, ha egy virtuálisgép-modell megváltozik, az Azure-beli virtuálisgép-ügynök letölti és frissíti a bővítményt.

Az automatikus bővítményfrissítések alverziók vagy gyorsjavítások. A bővítmény kiépítésekor engedélyezheti vagy letilthatja az apróbb frissítéseket. Az alábbi példa bemutatja, hogyan frissíthet automatikusan alverziókat egy ARM-sablonban a "autoUpgradeMinorVersion": true, paraméter használatával:

    "properties": {
    "publisher": "Microsoft.Compute",
    "type": "CustomScriptExtension",
    "typeHandlerVersion": "1.9",
    "autoUpgradeMinorVersion": true,
    "settings": {
        "fileUris": [
        "https://raw.githubusercontent.com/Microsoft/dotnet-core-sample-templates/master/dotnet-core-music-windows/scripts/configure-music-app.ps1"
        ]
    },

A legújabb kisebb kiadású hibajavítások beszerzéséhez javasoljuk, hogy mindig válassza ki az automatikus frissítést a bővítménytelepítésekben. Nem tilthatja le a biztonsági vagy kulcshibás javításokat tartalmazó gyorsjavítás-frissítéseket.

Ha letiltja az automatikus frissítéseket, vagy frissítenie kell egy főverziót, használja a Set-AzVMExtension parancsot, és adja meg a célverziót.

Bővítményfrissítések azonosítása

A bővítmények frissítéseit többféleképpen is azonosíthatja.

Annak azonosítása, hogy a bővítmény az autoUpgradeMinorVersion beállítással van-e beállítva egy virtuális gépen

Megtekintheti a virtuálisgép-modellt annak megállapításához, hogy a bővítmény ki van-e építve a autoUpgradeMinorVersion paraméterrel. A virtuálisgép-modell ellenőrzéséhez használja a Get-AzVm parancsot, és adja meg az erőforráscsoportot és a virtuális gép nevét az alábbiak szerint:

 $vm = Get-AzVm -ResourceGroupName "myResourceGroup" -VMName "myVM"
 $vm.Extensions

Az alábbi példakimenet azt mutatja, hogy a autoUpgradeMinorVersion paraméter a következőre truevan állítva:

ForceUpdateTag              :
Publisher                   : Microsoft.Compute
VirtualMachineExtensionType : CustomScriptExtension
TypeHandlerVersion          : 1.9
AutoUpgradeMinorVersion     : True

AutoUpgradeMinorVersion esemény bekövetkezésének azonosítása

A bővítmény frissítésének időpontjáról a C:\WindowsAzure\Logs\WaAppAgent.log címen tekintheti át a virtuális gépen található ügynöknaplókat.

Az alábbi példa a telepített verziójú Microsoft.Compute.CustomScriptExtension 1.8 virtuális gépet és a verzióhoz 1.9elérhető gyorsjavítást mutatja be.

[INFO]  Getting plugin locations for plugin 'Microsoft.Compute.CustomScriptExtension'. Current Version: '1.8', Requested Version: '1.9'
[INFO]  Auto-Upgrade mode. Highest public version for plugin 'Microsoft.Compute.CustomScriptExtension' with requested version: '1.9', is: '1.9'

Ügynök engedélyei

A feladatai elvégzéséhez az Azure-beli virtuálisgép-ügynöknek helyi rendszerként kell futnia.

Virtuálisgép-bővítmények hibaelhárítása

Az egyes virtuálisgép-bővítmények hibaelhárítási lépései lehetnek. Ha például az Egyéni szkriptbővítményt használja, a parancsprogram végrehajtásának részleteit helyileg megtalálhatja azon a virtuális gépen, amelyen a bővítmény fut.

Az alábbi hibaelhárítási műveletek az összes virtuálisgép-bővítményre vonatkoznak:

  • Az Azure-beli virtuálisgép-ügynök naplójának ellenőrzéséhez tekintse meg a bővítmény üzembe helyezésekor a C:\WindowsAzure\Logs\WaAppAgent.log.

  • További részletekért tekintse meg a bővítménynaplókat a C:\WindowsAzure\Logs\Plugins<extensionName> fájlban.

  • Hibakódokat, ismert problémákat és egyéb bővítményspecifikus információkat a bővítményspecifikus dokumentáció hibaelhárítási szakaszaiban talál.

  • Nézze meg a rendszernaplókat. Ellenőrizze, hogy vannak-e olyan műveletek, amelyek zavarhatják a bővítményt, például egy másik alkalmazás hosszú ideig futó telepítése, amely kizárólagos hozzáférést igényelt a csomagkezelőhöz.

  • Ha egy virtuális gépen egy meglévő, sikertelen kiépítési állapotú bővítmény található, a többi új bővítmény telepítése sikertelen.

A bővítményhibák gyakori okai

Az alábbiakban néhány gyakori oka lehet annak, hogy egy bővítmény meghiúsulhat:

  • A bővítmények futtatásához 20 perc áll rendelkezésére. (Kivételek az egyéni szkriptek, a Chef és a DSC, amelyek 90 perc.) Ha az üzemelő példány túllépi ezt az időt, időtúllépésként van megjelölve. A probléma oka lehet az alacsony erőforrásigényű virtuális gépek, vagy más virtuálisgép-konfigurációk vagy indítási feladatok nagy mennyiségű erőforrást használnak fel, miközben a bővítmény kiépíteni próbál.

  • A minimális előfeltételek nem teljesülnek. Egyes bővítmények függőségekkel rendelkeznek a virtuálisgép-termékváltozatokhoz, például a HPC-lemezképekhez. A bővítmények bizonyos hálózati hozzáférési követelményekkel rendelkezhetnek, például az Azure Storage-ral vagy a közszolgáltatásokkal való kommunikációhoz. Ilyen lehet például a csomagtárakhoz való hozzáférés, a lemezterület elfogyása vagy a biztonsági korlátozások.

  • A Csomagkezelő hozzáférése kizárólagos. Bizonyos esetekben előfordulhat, hogy a virtuális gép hosszan futó konfigurációja és bővítménytelepítése ütközik, mert mindkettőnek kizárólagos hozzáférésre van szüksége a csomagkezelőhöz.

Bővítmény állapotának megtekintése

Miután egy virtuálisgép-bővítményt futtatott egy virtuális gépen, a Get-AzVM paranccsal adja vissza a bővítmény állapotát. Az Substatuses[0] eredmény azt mutatja, hogy a bővítmény kiépítése sikeres volt, ami azt jelenti, hogy sikeresen üzembe lett helyezve a virtuális gépen. Ha megjelenik az Substatuses[1] eredmény, a bővítmény végrehajtása sikertelen volt a virtuális gépen belül.

Get-AzVM -ResourceGroupName "myResourceGroup" -VMName "myVM" -Status

A kimenet a következő példához hasonló:

Extensions[0]           :
  Name                  : CustomScriptExtension
  Type                  : Microsoft.Compute.CustomScriptExtension
  TypeHandlerVersion    : 1.9
  Substatuses[0]        :
    Code                : ComponentStatus/StdOut/succeeded
    Level               : Info
    DisplayStatus       : Provisioning succeeded
    Message             : Windows PowerShell \nCopyright (C) Microsoft Corporation. All rights reserved.\n
  Substatuses[1]        :
    Code                : ComponentStatus/StdErr/succeeded
    Level               : Info
    DisplayStatus       : Provisioning succeeded
    Message             : The argument 'cseTest%20Scriptparam1.ps1' to the -File parameter does not exist. Provide the path to an existing '.ps1' file as an argument to the

-File parameter.
  Statuses[0]           :
    Code                : ProvisioningState/failed/-196608
    Level               : Error
    DisplayStatus       : Provisioning failed
    Message             : Finished executing command

A bővítmények végrehajtási állapotát az Azure Portalon is megtalálhatja. Válassza ki a virtuális gépet, válassza a Bővítmények lehetőséget, majd válassza ki a kívánt bővítményt.

Virtuálisgép-bővítmény újrafuttatása

Bizonyos esetekben előfordulhat, hogy újra kell futtatnia egy virtuálisgép-bővítményt. A bővítmény újrafuttatásához távolítsa el a bővítményt, majd futtassa újra a bővítményt egy tetszőleges végrehajtási módszerrel. Bővítmény eltávolításához használja a Remove-AzVMExtension parancsot az alábbiak szerint:

Remove-AzVMExtension -ResourceGroupName "myResourceGroup" -VMName "myVM" -Name "myExtensionName"

A bővítményeket az Azure Portalon is eltávolíthatja. Válasszon ki egy virtuális gépet, válassza a Bővítmények lehetőséget, majd válassza ki a kívánt bővítményt. Válassza az Uninstall lehetőséget.

A virtuálisgép-bővítmények gyakori referenciája

Az alábbi táblázat néhány gyakori hivatkozást tartalmaz a virtuálisgép-bővítményekhez.

Bővítmény neve Leírás
Egyéni szkriptbővítmények a Windowshoz Szkriptek futtatása Azure-beli virtuális gépen.
DSC-bővítmény Windowshoz A Kívánt PowerShell-állapotkonfigurációk alkalmazása egy virtuális gépre.
Azure Diagnostics-bővítmény Az Azure Diagnostics kezelése.
VMAccess-bővítmény Felhasználók és hitelesítő adatok kezelése.

Következő lépések

A virtuálisgép-bővítményekkel kapcsolatos további információkért lásd az Azure-beli virtuálisgép-bővítményeket és -funkciókat.