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

  • Cikk

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

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

Másik lehetőségként az összes SQL Server virtuális gépet automatikusan vagy manuálisan is regisztrálhatja.

Feljegyzés

Az Azure Marketplace-en 2022 októbere után üzembe helyezett SQL Server virtuális gépek alapértelmezés szerint a legkevésbé kiemelt modellel rendelkeznek. 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 parancsmag segítségével regisztrálhatja az összes virtuális gépet egy adott előfizetések, erőforráscsoportok vagy adott virtuális gépek 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 az SQL Server szolgáltatást vagy a virtuális gépet.

Alapértelmezés szerint az SQL Server 2016 vagy újabb rendszerű Azure-beli virtuális gépek automatikusan regisztrálva lesznek az SQL IaaS Agent bővítményben, 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 tekintse meg az SQL IaaS Agent bővítmény adatvédelmi nyilatkozatait.

Előfeltételek

Ha az SQL Server virtuális gépet a bővítménysel szeretné regisztrálni, a következőkre lesz szüksége:

Első lépések

Mielőtt továbblép, először létre kell hoznia egy helyi másolatot a szkriptről, importálnia kell PowerShell-modulként, é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 RegisterSqlVMs.psm1.

A szkript importálása

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

Nyisson meg egy felügyeleti PowerShell-terminált, és keresse meg a fájl mentési RegisterSqlVMs.psm1 helyét. Ezután futtassa a következő PowerShell-parancsmagot a szkript modulként való 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

A következő parancsmaggal regisztrálhatja az összes SQL Server virtuális gépet több erőforráscsoportban egyetlen előfizetésen belül:

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 olyan .txt fájlként jön létre, amelynek az RegisterSqlVMScriptReport<Timestamp>.txt időbélyege a parancsmag elindításának időpontja. A jelentés a következő részleteket 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 keresésével.
Azon előfizetések száma, amelyek nem próbálhatók ki, mert nincsenek regisztrálva az erőforrás-szolgáltatóhoz Ez a szakasz azOKNAK az előfizetéseknek a számát és listáját tartalmazza, amelyek nem lettek regisztrálva az SQL IaaS Agent bővítményben.
Ö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 Azoknak a virtuális gépeknek a száma, amelyeket kihagytak, 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épek formátuma SubscriptionID, Resource Group, Virtual Machine.
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.
A virtuális gép vagy a virtuális gépen lévő gust-ügynök futtatásakor kihagyott virtuális gépek száma A virtuális gépként vagy vendégügynökként nem regisztrálható virtuális gépek száma és listája nem futott. Ezeket a virtuális gép vagy vendégügynök elindítása után újrapróbálhatja. A részletek a naplófájlban találhatók.
Kihagyott virtuális gépek száma, mivel nem futtatják az SQL Servert Windows rendszeren Azoknak a virtuális gépeknek a száma, amelyeket kihagytak, mert nem SQL Servert futtatnak, vagy nem Windows rendszerű virtuális gépek. A virtuális gépek a formátumban SubscriptionID, Resource Group, Virtual Machinejelennek meg.

Napló

A hibák a naplófájlban VMsNotRegisteredDueToError<Timestamp>.logvannak 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 SQL Server virtuális gépeket regisztrál a bővítményhez a megadott szkript használatával, vegye figyelembe a következőket:

  • A bővítményre való regisztrációhoz az SQL Server virtuális gépen futó vendégügynökre van szükség. A Windows Server 2008 rendszerképek nem rendelkeznek vendégügynökkel, ezért ezek a virtuális gépek sikertelenek lesznek, és manuálisan kell regisztrálni korlátozott funkcionalitással.
  • A beépített újrapróbálkozások a transzparens hibák elhárításához. Ha a virtuális gép sikeresen regisztrálva van, akkor gyors művelet. Ha azonban a regisztráció sikertelen, minden virtuális gép újrapróbálkozásra kerü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 futó teljes szkriptért tekintse meg az SQL Server virtuális gépek tömeges regisztrálását 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 az alábbi cikkeket: