Több SQL-virtuális gép regisztrálása az Azure-ban az SQL IaaS-ügynökbővítménnyel

  • Cikk

A következőkre vonatkozik: SQL Server Azure-beli virtuális gépen

Ez a cikk azt ismerteti, hogyan regisztrálhatja a SQL Server virtuális gépeket (VM-eket) tömegesen az Azure-ban az SQL IaaS-ügynök bővítményével a Register-SqlVMsAzure PowerShell parancsmag használatával.

Azt is megteheti, hogy az összes SQL Server virtuális gépet automatikusan regisztrálja, vagy az egyes SQL Server virtuális gépeket manuálisan.

Megjegyzés

SQL Server 2022 októbere után az Azure Marketplace-en üzembe helyezett virtuális gépek alapértelmezés szerint a legkevésbé kiemelt modellt használják. Az SQL IaaS-ügynök bővítmény felügyeleti módjai 2023 márciusában el lettek távolítva.

Áttekintés

A Register-SqlVMs parancsmaggal regisztrálhatja az összes virtuális gépet az előfizetések, erőforráscsoportok vagy adott virtuális gépek adott listájában. A parancsmag regisztrálja a virtuális gépeket, majd létrehoz egy jelentést és egy naplófájlt is.

A regisztrációs folyamat nem jár kockázattal, nincs állásidő, és nem indítja újra a SQL Server szolgáltatást vagy a virtuális gépet.

Alapértelmezés szerint a 2016-os vagy újabb SQL Server rendelkező Azure-beli virtuális gépek automatikusan regisztrálva lesznek az SQL IaaS-ügynök bővítményében, amikor a CEIP szolgáltatás észleli. Tömeges regisztrációval regisztrálhat minden olyan SQL Server virtuális gépet, amelyet a CEIP szolgáltatás nem észlel.

Az adatvédelemmel kapcsolatos információkért lásd az SQL IaaS-ügynök bővítményének adatvédelmi nyilatkozatait.

Előfeltételek

A SQL Server virtuális gép bővítményben való regisztrálásához a következőkre lesz szüksége:

Bevezetés

A folytatás előtt létre kell hoznia a szkript egy helyi példányát, PowerShell-modulként kell importálnia, és csatlakoznia kell az Azure-hoz.

A szkript létrehozása

A szkript létrehozásához másolja a teljes szkriptet a cikk végére, és mentse helyileg a következőként: RegisterSqlVMs.psm1.

A szkript importálása

A szkript létrehozása után importálhatja modulként a PowerShell-terminálba.

Nyisson meg egy felügyeleti PowerShell-terminált, és navigáljon oda, ahová a fájlt mentette RegisterSqlVMs.psm1 . Ezután futtassa a következő PowerShell-parancsmagot a szkript modulként történő importálásához:

Import-Module .\RegisterSqlVMs.psm1

Csatlakozás az Azure szolgáltatáshoz

Az Azure-hoz való csatlakozáshoz használja a következő PowerShell-parancsmagot:

Connect-AzAccount

Az előfizetések listájában szereplő összes virtuális gép

Az alábbi parancsmaggal regisztrálhatja az összes SQL Server virtuális gépet az előfizetések listájában:

Register-SqlVMs -SubscriptionList SubscriptionId1,SubscriptionId2

Példa a kimenetre:

Number of subscriptions registration failed for 
because you do not have access or credentials are wrong: 1
Total VMs Found: 10
VMs Already registered: 1
Number of VMs registered successfully: 4
Number of VMs failed to register due to error: 1
Number of VMs skipped as VM or the guest agent on VM is not running: 3
Number of VMs skipped as they are not running SQL Server On Windows: 1

Please find the detailed report in file RegisterSqlVMScriptReport1571314821.txt
Please find the error details in file VMsNotRegisteredDueToError1571314821.log

Egyetlen előfizetés összes virtuális gépe

Az alábbi parancsmaggal regisztrálhatja az összes SQL Server virtuális gépet egyetlen előfizetésben:

Register-SqlVMs -Subscription SubscriptionId1

Példa a kimenetre:

Total VMs Found: 10
VMs Already registered: 1
Number of VMs registered successfully: 5
Number of VMs failed to register due to error: 1
Number of VMs skipped as VM or the  guest agent on VM is not running: 2
Number of VMs skipped as they are not running SQL Server On Windows: 1

Please find the detailed report in file RegisterSqlVMScriptReport1571314821.txt
Please find the error details in file VMsNotRegisteredDueToError1571314821.log

Több erőforráscsoport összes virtuális gépe

Az alábbi parancsmaggal regisztrálhatja az összes SQL Server virtuális gépet egyetlen előfizetés több erőforráscsoportjában:

Register-SqlVMs -Subscription SubscriptionId1 -ResourceGroupList ResourceGroup1,ResourceGroup2

Példa a kimenetre:

Total VMs Found: 4
VMs Already registered: 1
Number of VMs registered successfully: 1
Number of VMs failed to register due to error: 1
Number of VMs skipped as they are not running SQL Server On Windows: 1

Please find the detailed report in file RegisterSqlVMScriptReport1571314821.txt
Please find the error details in file VMsNotRegisteredDueToError1571314821.log

Egy erőforráscsoport összes virtuális gépe

Az alábbi parancsmaggal regisztrálhatja az összes SQL Server virtuális gépet egyetlen erőforráscsoportban:

Register-SqlVMs -Subscription SubscriptionId1 -ResourceGroupName ResourceGroup1

Példa a kimenetre:

Total VMs Found: 4
VMs Already registered: 1
Number of VMs registered successfully: 1
Number of VMs failed to register due to error: 1
Number of VMs skipped as VM or the guest agent on VM is not running: 1

Please find the detailed report in file RegisterSqlVMScriptReport1571314821.txt
Please find the error details in file VMsNotRegisteredDueToError1571314821.log

Adott virtuális gépek egyetlen erőforráscsoportban

Az alábbi parancsmaggal regisztrálhat adott SQL Server virtuális gépeket egyetlen erőforráscsoporton belül:

Register-SqlVMs -Subscription SubscriptionId1 -ResourceGroupName ResourceGroup1 -VmList VM1,VM2,VM3

Példa a kimenetre:

Total VMs Found: 3
VMs Already registered: 0
Number of VMs registered successfully: 1
Number of VMs skipped as VM or the guest agent on VM is not running: 1
Number of VMs skipped as they are not running SQL Server On Windows: 1

Please find the detailed report in file RegisterSqlVMScriptReport1571314821.txt
Please find the error details in file VMsNotRegisteredDueToError1571314821.log

Egy adott virtuális gép

Az alábbi parancsmaggal regisztrálhat egy adott SQL Server virtuális gépet:

Register-SqlVMs -Subscription SubscriptionId1 -ResourceGroupName ResourceGroup1 -Name VM1

Példa a kimenetre:

Total VMs Found: 1
VMs Already registered: 0
Number of VMs registered successfully: 1

Please find the detailed report in  file RegisterSqlVMScriptReport1571314821.txt

Kimenet leírása

A rendszer a parancsmag minden használatakor Register-SqlVMs létrehoz egy jelentést és egy naplófájlt is.

Jelentés

A jelentés egy .txt nevű RegisterSqlVMScriptReport<Timestamp>.txt fájlként jön létre, ahol az időbélyeg a parancsmag indításának időpontja. A jelentés a következő adatokat sorolja fel:

Kimeneti érték Leírás
Az előfizetések regisztrációjának száma nem sikerült, mert nem rendelkezik hozzáféréssel, vagy a hitelesítő adatok helytelenek Ez a megadott hitelesítéssel kapcsolatos problémákat okozó előfizetések számát és listáját tartalmazza. A részletes hiba a naplóban található az előfizetés azonosítójának megkeresésével.
Azoknak az előfizetéseknek a száma, amelyeket nem sikerült megpróbálni, mert nincsenek regisztrálva az erőforrás-szolgáltatóban Ez a szakasz azOKNAK az előfizetéseknek a számát és listáját tartalmazza, amelyek nincsenek regisztrálva az SQL IaaS-ügynök bővítményében.
Összes talált virtuális gép A parancsmagnak átadott paraméterek hatókörében található virtuális gépek száma.
Már regisztrált virtuális gépek A kihagyott virtuális gépek száma, mivel már regisztrálva voltak a bővítményben.
A sikeresen regisztrált virtuális gépek száma A parancsmag futtatása után sikeresen regisztrált virtuális gépek száma. A regisztrált virtuális gépeket a következő formátumban SubscriptionID, Resource Group, Virtual Machinesorolja fel: .
Azoknak a virtuális gépeknek a száma, amelyet hiba miatt nem sikerült regisztrálni Azon virtuális gépek száma, amelyek valamilyen hiba miatt nem voltak regisztrálva. A hiba részletei a naplófájlban találhatók.
Azoknak a virtuális gépeknek a száma, amikor a virtuális gép vagy a Gust-ügynök nem fut a virtuális gépen Azoknak a virtuális gépeknek a száma és listája, amelyeket nem lehetett virtuális gépként vagy vendégügynökként regisztrálni a virtuális gépen, nem futottak. Ezek a virtuális gép vagy a vendégügynök elindítása után újrapróbálkozhatók. A részletek a naplófájlban találhatók.
A kihagyott virtuális gépek száma, mivel nem futnak SQL Server Windows rendszeren A kihagyott virtuális gépek száma, mivel nem SQL Server futnak, vagy nem Windows rendszerű virtuális gépek. A virtuális gépek a következő formátumban SubscriptionID, Resource Group, Virtual Machinejelennek meg: .

Napló

A hibák a nevű VMsNotRegisteredDueToError<Timestamp>.lognaplófájlban vannak naplózva, ahol az időbélyeg a szkript indításának időpontja. Ha a hiba az előfizetés szintjén van, a napló tartalmazza a vesszővel tagolt előfizetés-azonosítót és a hibaüzenetet. Ha a hiba a virtuális gép regisztrációjával kapcsolatos, a napló vesszővel elválasztva tartalmazza az előfizetés azonosítóját, az erőforráscsoport nevét, a virtuális gép nevét, a hibakódot és az üzenetet.

Megjegyzések

Ha a megadott szkripttel regisztrál SQL Server virtuális gépeket a bővítménnyel, vegye figyelembe a következőket:

  • A bővítménnyel való regisztrációhoz egy vendégügynökre van szükség, amely a SQL Server virtuális gépen fut. A Windows Server 2008 rendszerképei nem rendelkeznek vendégügynökkel, ezért ezek a virtuális gépek sikertelenek lesznek, és korlátozott funkcionalitássalmanuálisan kell regisztrálni őket.
  • A beépített újrapróbálkozások logikája segít leküzdeni az átlátható hibákat. Ha a virtuális gép sikeresen regisztrálva van, akkor gyors művelet. Ha azonban a regisztráció sikertelen, a rendszer minden virtuális gépet újrapróbál. Ezért jelentős időt kell hagynia a regisztrációs folyamat befejezésére , bár a tényleges időkövetelmény a hibák típusától és számától függ.

Teljes szkript

A GitHubon található teljes szkriptért lásd: Virtuális gépek tömeges regisztrálása SQL Server az Az PowerShell-lel.

Másolja ki a teljes szkriptet, és mentse a következőként: RegisterSqLVMs.psm1.

Következő lépések

További információért tekintse át a következő cikkeket: