Compartir a través de


Registro de varias máquinas virtuales con SQL en Azure con la extensión Agente de IaaS de SQL

Se aplica a: SQL Server en máquina virtual de Azure

En este artículo se describe cómo registrar de forma masiva máquinas virtuales con SQL Server en Azure con la extensión Agente de IaaS de SQL mediante el cmdlet Register-SqlVMs de Azure PowerShell.

Como alternativa, puede registrar todas las VM con SQL Server automáticamente o VM con SQL Server individuales manualmente.

Nota:

Las VM con SQL Server implementadas a través de Azure Marketplace después de octubre de 2022 tienen habilitado el modelo con privilegios mínimos de manera predeterminada. Los modos de administración de la extensión Agente de IaaS de SQL se quitaron en marzo de 2023.

Introducción

El cmdlet Register-SqlVMs se puede usar para registrar todas las máquinas virtuales en una lista determinada de suscripciones, grupos de recursos o una lista de máquinas virtuales específicas. El cmdlet registrará las máquinas virtuales y, luego, generará tanto uninforme como un archivo de registro.

El proceso de registro no conlleva ningún riesgo, no tiene ningún tiempo de inactividad y no reiniciará el servicio SQL Server ni la máquina virtual.

De manera predeterminada, las máquinas virtuales de Azure con SQL Server 2016 o versiones posteriores se registran automáticamente con la extensión Agente de IaaS de SQL cuando el servicio CEIP las detecta. Puede usar el registro masivo para registrar las VM con SQL Server que no detecte el servicio CEIP.

Para información sobre la privacidad, consulte las declaraciones de privacidad de la extensión Agente de IaaS de SQL.

Requisitos previos

Para registrar una máquina virtual con SQL Server con la extensión, necesita lo siguiente:

  • Una suscripción de Azure que se ha registrado con el proveedor de recursosproveedor Microsoft.SqlVirtualMachiney que contiene máquinas virtuales con SQL Server no registradas.
  • Asegúrese que la VM de Azure esté ejecutándose.
  • Las credenciales de cliente que se usan para registrar las máquinas virtuales existen en cualquiera de los siguientes roles de Azure: colaborador de la máquina virtual, colaborador o propietario.
  • Az PowerShell 5.0: las versiones posteriores a 5.0 actualmente solo admiten MFA y no son compatibles con el script para registrar varias máquinas virtuales.

Introducción

Antes de continuar, primero debe crear una copia local del script, importarlo como un módulo de PowerShell y conectarse a Azure.

Cree el script

Para crear el script, copie el script completo del final de este artículo y guárdelo localmente como RegisterSqlVMs.psm1.

Importación del script

Una vez creado el script, puede importarlo como un módulo en el terminal de PowerShell.

Abra un terminal de PowerShell administrativo y navegue hasta la ubicación en la que guardó el archivo RegisterSqlVMs.psm1. Después, ejecute el siguiente cmdlet de PowerShell para importar el script como un módulo:

Import-Module .\RegisterSqlVMs.psm1

Conexión con Azure

Use el siguiente cmdlet de PowerShell para conectarse a Azure:

Connect-AzAccount

Todas las máquinas virtuales en una lista de suscripciones

Use el siguiente cmdlet para registrar todas las máquinas virtuales con SQL Server en una lista de suscripciones:

Register-SqlVMs -SubscriptionList SubscriptionId1,SubscriptionId2

Salida de ejemplo:

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

Todas las máquinas virtuales en una sola suscripción

Use el siguiente cmdlet para registrar todas las máquinas virtuales con SQL Server en una sola suscripción:

Register-SqlVMs -Subscription SubscriptionId1

Salida de ejemplo:

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

Todas las máquinas virtuales en varios grupos de recursos

Use el siguiente cmdlet para registrar todas máquinas virtuales con SQL Server en varios grupos de recursos dentro de una sola suscripción:

Register-SqlVMs -Subscription SubscriptionId1 -ResourceGroupList ResourceGroup1,ResourceGroup2

Salida de ejemplo:

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

Todas las máquinas virtuales en un grupo de recursos

Use el siguiente cmdlet para registrar todas las máquinas virtuales con SQL Server en un solo grupo de recursos:

Register-SqlVMs -Subscription SubscriptionId1 -ResourceGroupName ResourceGroup1

Salida de ejemplo:

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

Máquinas virtuales específicas en un solo grupo de recursos

Use el siguiente cmdlet para registrar máquinas virtuales con SQL Server específicas dentro de un solo grupo de recursos:

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

Salida de ejemplo:

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

Una máquina virtual específica

Use el siguiente cmdlet para registrar una máquina virtual con SQL Server específica:

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

Salida de ejemplo:

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

Please find the detailed report in  file RegisterSqlVMScriptReport1571314821.txt

Descripción de la salida

Se genera un informe y un archivo de registro cada vez que se usa el cmdlet Register-SqlVMs.

Informe

El informe se genera como un archivo .txt denominado RegisterSqlVMScriptReport<Timestamp>.txt en el que la marca de tiempo es la hora en la que se inició el cmdlet. El informe enumera los detalles siguientes:

Valor de salida Descripción
No se pudo registrar el número de suscripciones porque no tiene acceso o las credenciales son incorrectas Esto proporciona el número y la lista de suscripciones que tenían problemas con la autenticación proporcionada. El error detallado se puede encontrar en el registro buscando el identificador de la suscripción.
Número de suscripciones que no se pudieron intentar porque no están registradas en el proveedor de recursos Esta sección contiene el recuento y la lista de suscripciones que no se han registrado en la extensión Agente de IaaS de SQL.
Máquinas virtuales totales encontradas Recuento de máquinas virtuales que se encontraron en el ámbito de los parámetros pasados al cmdlet.
Máquinas virtuales ya registradas Recuento de máquinas virtuales que se omitieron porque ya estaban registradas con la extensión.
Número de máquinas virtuales registradas correctamente Recuento de máquinas virtuales que se registraron correctamente después de ejecutar el cmdlet. Enumera las máquinas virtuales registradas en el formato SubscriptionID, Resource Group, Virtual Machine.
Número de máquinas virtuales que no se pudieron registrar debido a un error Recuento de máquinas virtuales que no se pudieron registrar debido a algún error. Los detalles del error se pueden encontrar en el archivo de registro.
Número de máquinas virtuales omitidas porque la máquina virtual o el agente invitado de la máquina virtual no se está ejecutando Recuento y la lista de máquinas virtuales que no se pudieron registrar porque la máquina virtual o el agente invitado de la máquina virtual no se estaba ejecutando. Se pueden reintentar una vez que se haya iniciado la máquina virtual o el agente invitado. Se puede encontrar más información en el archivo de registro.
Número de máquinas virtuales omitidas porque no están ejecutando SQL Server en Windows Recuento de máquinas virtuales que se omitieron porque no están ejecutando SQL Server o no son una máquina virtual de Windows. Las máquinas virtuales se enumeran en el formato SubscriptionID, Resource Group, Virtual Machine.

Log

Los errores se registran en el archivo de registro denominado VMsNotRegisteredDueToError<Timestamp>.log, donde la marca de tiempo es la hora a la que se inició el script. Si el error se encuentra en el nivel de suscripción, el registro contiene el identificador de suscripción separado por comas y el mensaje de error. Si el error está en el registro de la máquina virtual, el registro contiene el identificador de la suscripción, el nombre del grupo de recursos, el nombre de la máquina virtual, el código de error y el mensaje, separados por comas.

Observaciones

Al registrar máquinas virtuales con SQL Server con la extensión mediante el script proporcionado, tenga en cuenta lo siguiente:

  • El registro con la extensión requiere un agente invitado que se ejecute en la máquina virtual con SQL Server. Las imágenes de Windows Server 2008 no tienen un agente invitado, por lo que se producirá un error en estas máquinas virtuales y se deberán registrar manualmente con funcionalidad limitada.
  • Hay una lógica de reintento integrada para solucionar errores transparentes. Si la máquina virtual se ha registrado correctamente, es una operación rápida. Sin embargo, si se produce un error en el registro, se reintentará cada máquina virtual. Como tal, debe permitir un tiempo considerable para completar el proceso de registro (aunque el requisito de tiempo real depende del tipo y número de errores).

Script completo

Para el script completo en GitHub, consulte Registro de forma masiva de máquinas virtuales con SQL Server con Az PowerShell.

Copie el script completo y guárdelo como RegisterSqLVMs.psm1.

Pasos siguientes

Para obtener más información, consulte los artículos siguientes: