Compartir a través de

Recopila registros a demanda con las operaciones sin conexión para el módulo de PowerShell de Azure Local

En este artículo se explica cómo recopilar registros a petición para operaciones desconectadas para Azure Local mediante el módulo de PowerShell. Aprenderá a proporcionar registros para solucionar problemas y soporte técnico cuando Azure Local funciona en modo desconectado.

Acerca de la recopilación de registros a petición

La recopilación de registros a petición implica recopilar y enviar manualmente registros de diagnóstico a Microsoft. Estos registros se almacenan en una base de datos de Azure Data Explorer a la que Soporte técnico de Microsoft puede acceder para ayudar a investigar y resolver los problemas notificados. Los datos de diagnóstico recopilados se conservan durante un máximo de 30 días y se administran según las prácticas de privacidad estándar de Microsoft.

La recopilación de registros ayuda a diagnosticar y solucionar problemas en las operaciones desconectadas para Azure Local. Use esta característica para enviar registros a Soporte técnico de Microsoft. Los registros incluyen detalles sobre el entorno de operaciones desconectados, como el punto de conexión de administración, el entorno de ejecución integrado y otros componentes. Durante la recopilación de registros, es posible que se produzcan errores debido a limitaciones del entorno o de las herramientas.

Importante

Antes de usar la recopilación de registros directos a petición, complete los requisitos previos y configure la observabilidad con el cmdlet . Si omite estos pasos, es posible que vea un error.

Prerrequisitos

Antes de configurar la observabilidad para el dispositivo de Azure Local, asegúrese de que:

  • Implementar Operaciones Desconectadas para Azure Local
  • Configuración de la observabilidad para diagnósticos y soporte técnico
  • Tenga suficiente espacio en disco para los registros:
    • Para la recopilación de registros típica: al menos 25 GB de espacio libre.
    • Para agrupaciones de registros más grandes, como los registros de los dispositivos:
      • Los registros comprimidos pueden superar los 25 GB
      • Los registros sin comprimir requieren más espacio.
    • Como regla, mantenga al menos dos veces el tamaño de registro comprimido disponible. Por ejemplo:
      • Para un lote de registros comprimido de 10 GB, mantenga al menos 20 GB libres.
      • Para un paquete comprimido de 25 GB, mantenga al menos 50 GB libres.

Nota:

Cargue registros en lotes pequeños para reducir el tiempo de procesamiento y el uso del disco. Antes de empezar, compruebe el espacio en disco para evitar errores debido a un almacenamiento bajo.

Flujo de trabajo

Para recopilar registros a petición, siga estos pasos:

  • Requisitos previos
  • Selección de un método de recopilación de registros para el escenario de conectividad
  • Recopilación de registros
  • Supervisión de la recopilación de registros
  • Revisar los registros localmente o enviarlos a Microsoft

Configuración de la observabilidad para diagnósticos y soporte técnico

Se recomienda configurar la observabilidad para obtener datos de telemetría y registros para la primera implementación. Esto permite que Azure Local Desconectado se conecte a Azure a través del registro de Arc y use una identidad administrada para cargar registros, métricas y telemetría desde la máquina virtual del dispositivo.

Nota:

Configurar la observabilidad no se aplica si planea operar en una red aislada, ya que la telemetría y el diagnóstico requieren conectividad.

Esta es una lista de parámetros necesarios:

  • Grupo de recursos de Azure: cree un grupo de recursos en Azure para el aparato, como azure-disconnectedoperations.
  • Nombre Principal de Servicio (SPN): cree un SPN que tenga derechos sobre el grupo de recursos.
  • Credenciales de entidad de servicio: Obtenga el ID de la entidad de servicio (appId) y el secreto (contraseña).
  • Subscription: identifique la suscripción de Azure.
  • Id. de inquilino: identifique el identificador de inquilino.
  • Azure región: especifique la región Azure (ubicación) para la implementación.
  • Proveedores de recursos necesarios: registre estos proveedores de recursos en la suscripción:
    • Microsoft.Compute (para actualizaciones de extensiones y Update Manager)
    • Microsoft.AzureArcData (si usa SQL habilitado para Arc)
    • Microsoft.HybridConnectivity
    • Microsoft.GuestConfiguration
    • Microsoft.HybridCompute
  • Connectivity: asegúrese de que el dispositivo puede conectarse a Azure para la telemetría y el diagnóstico.

Siga estos pasos para configurar la observabilidad para diagnósticos y soporte técnico:

  1. Inicie sesión en Azure. Use CLI de Azure o Azure Cloud Shell y ejecute este comando:

    az login

  2. Cree un grupo de recursos con el mismo nombre que usó en DeviceARMResourceURI. Ejecute este comando:

    az group create -g <ResourceGroupName> -l <AzureRegion>

  3. Identifique la nube activa. Ejecute este comando:

    az cloud list -o table

  4. Obtenga los identificadores de suscripción e inquilino. Ejecute este comando:

    az account show

  5. Crear una entidad de servicio. Reemplace SubscriptionID por el identificador de suscripción y ejecute este comando:

    az ad sp create-for-rbac --name "<SPNName>" --role "Azure Connected Machine Resource Administrator" --scopes /subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>

    Ejemplo de resultado:

    {
  "appId": "<AppId>",
  "displayName": "<SPNName>",
  "password": "<RETRACTED>",
  "tenant": "<RETRACTED>"
}

    Nota:

    Usar el appID como el ID de Servicio Principal y la contraseña como el Secreto de Servicio Principal

  6. Establezca la configuración de observabilidad. Cambie los valores para que coincidan con los detalles del entorno.

    $observabilityConfiguration = New-ApplianceObservabilityConfiguration -ResourceGroupName "azure-disconnectedoperations" -TenantId "<TenantID>" -Location "<Location>" -SubscriptionId "<SubscriptionId>" -ServicePrincipalId "<AppId>" -ServicePrincipalSecret ("<Password>"|ConvertTo-SecureString -AsPlainText -Force)

Set-ApplianceObservabilityConfiguration -ObservabilityConfiguration $observabilityConfiguration

    Nota:

    Si desea configurar la observabilidad como parte de una implementación inicial, puede pasar como parámetro a y omitir . Esto simplifica la implementación y le ayuda a obtener registros y telemetría como parte de la implementación.

  7. Compruebe que la observabilidad está configurada.

    Get-ApplianceObservabilityConfiguration

Escenarios admitidos

Se admiten los siguientes escenarios a petición para la recopilación de registros:

Escenario para la recopilación de registros Cómo recopilar registros
Use la recopilación de registros directa a petición cuando un dispositivo local con operaciones desconectadas de Azure Local se conecta a Azure y el punto de conexión de administración para las operaciones desconectadas es accesible. Para recopilar registros, ejecute el cmdlet .
Use la recopilación de registros indirectos a petición cuando un dispositivo local en el sitio usa operaciones desconectadas para Azure Local, no se puede conectar a Azure, pero todavía puede acceder al endpoint de gestión para las operaciones desconectadas. Desencadene la recopilación de registros con el cmdlet .
Después de ejecutar el cmdlet, use el cmdlet para cargar los registros del dispositivo (plano de control).

Usa el cmdlet Send-AzStackHciDiagnosticData para cargar registros de nodos de Azure Local host.
Utiliza la recopilación de registros de respaldo a petición cuando el punto de conexión de administración para las operaciones desconectadas no sea accesible o cuando el tiempo de ejecución integrado para operaciones desconectadas con máquinas virtuales locales de Azure (VM) esté inactivo. Recoja registros después de apagar la máquina virtual del appliance de operaciones desconectadas, montar y desbloquear los discos duros virtuales (VHD) y copiar los registros mediante el cmdlet, desde los VHD montados, en una ubicación local definida por el usuario. Para obtener más información, consulte Recopilación de registros de redundancia del sistema para operaciones desconectadas.
Use el cmdlet para enviar manualmente datos de diagnóstico a Microsoft.

Para obtener una lista de características no admitidas en modo desconectado, consulte Características no admitidas en modo desconectado.

Importante

No ejecute el cmdlet Send-DiagnosticData en los nodos host locales de Azure. Las operaciones desconectadas para el plano de control de Azure Local administran estos nodos. Ejecute el cmdlet desde una máquina Windows con conectividad Azure, como el equipo portátil o el escritorio.

Operaciones desconectadas para Azure Local cuando la máquina virtual de la aplicación está conectada a Azure

Cuando la máquina virtual del dispositivo está conectada a Azure, envíe registros del plano de control directamente mediante el cmdlet Invoke-ApplianceLogCollection. No es necesario guardarlos localmente. En el caso de los registros de nodos de host, use el cmdlet para copiar los registros y, a continuación, envíelos a Microsoft mediante el cmdlet .

En el diagrama siguiente se muestran los componentes clave de la recopilación de registros en operaciones desconectadas para Azure Local cuando la máquina virtual del dispositivo está conectada a Azure:

Diagram que muestra los componentes clave de un escenario de host conectado en operaciones desconectadas para Azure Local.

Nota:

Para cada implementación, la dirección IP de administración, el certificado de cliente del punto de conexión de administración y la contraseña de certificado son diferentes. Asegúrese de usar los valores correctos para la implementación.

Antes de recopilar registros en un escenario de operaciones desconectadas, asegúrese de:

  1. Complete cada uno de los requisitos previos.

  2. Instale el módulo de operaciones si no está instalado. Use el cmdlet y cambie la ruta de acceso para que coincida con la estructura de carpetas.

    Import-Module "<disconnected operations module folder path>\Azure.Local.DisconnectedOperations.psd1" -Force

    Ejemplo de resultado:

    PS C:\Users\administrator.s46r2004\Documents> Import-Module "Q:\AzureLocalVHD\OperationsModule\Azure.Local.DisconnectedOperations.psd1" -Force  
VERBOSE: [2025-03-26 19:49:12Z][Test-RunningRequirements] PSVersionTable:  

Name                           Value  
----                           -----  
PSVersion                      5.1.26100.2161  
PSEdition                      Desktop  
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}  
BuildVersion                   10.0.26100.2161  
CLRVersion                     4.0.30319.42000  
WSManStackVersion              3.0  
PSRemotingProtocolVersion      2.3  
SerializationVersion           1.1.0.1  

VERBOSE: See Readme.md for directions on how to use this module.

  3. Instale el módulo Azure Local necesario para la recopilación de registros.

    Import-Module "<Azure Local module folder path>\AzureLocal.Orchestration.psd1" -Force

    Ejemplo de resultado:

    PS C:\Users\administrator.s46r2004\Documents> Import-Module "Q:\AzureLocalVHD\Azurelocal.Orchestration\AzureLocal.Orchestration.psd1" -Force

CommandType        Name                                              Version        Source
-----------        ----                                              -------        ------
Function           Invoke-AzureLocalDisconnectedLogCollection        2602.1....    AzureLocal.Orchestration
Function           Invoke-AzureLocalEnvironmentValidation            2602.1....    AzureLocal.Orchestration

  4. Utilizar Implementa operaciones desconectadas de Azure Local para el punto de conexión de administración.

    • Identifique la dirección IP del punto de conexión de administración.

    • Identifique el certificado de cliente de administración utilizado para autenticarse con las operaciones desconectadas en el punto de conexión de administración local de Azure.

    • Configure el contexto de cliente del punto de conexión de administración. Ejecute este script:

      # Replace with your actual values
$certPassword = Read-Host -AsSecureString "Management endpoint client certificate password"
$context = Set-DisconnectedOperationsClientContext -ManagementEndpointClientCertificatePath "<Management Endpoint Client Cert Path>" -ManagementEndpointClientCertificatePassword $certPassword -ManagementEndpointIpAddress "<Management Endpoint IP address>"

  5. Recopilar registros del plano de control. Ejecute este comando en un sistema que pueda acceder a la máquina virtual del dispositivo (normalmente el mismo host de Hyper-V):

    Invoke-ApplianceLogCollection

    Este comando recopila registros de la máquina virtual del dispositivo y los envía directamente al soporte técnico de Microsoft.

    Ejemplo:

    $fromDate = (Get-Date).AddMinutes(-30)
$toDate = (Get-Date)
$operationId = Invoke-ApplianceLogCollection -FromDate $fromDate -ToDate $toDate

    Ejemplo de resultado:

    PS G:\azurelocal\OperationsModule> $fromDate = (Get-Date).AddMinutes(-30)
PS G:\azurelocal\OperationsModule> $toDate = (Get-Date)
PS G:\azurelocal\OperationsModule> $operationId = Invoke-ApplianceLogCollection -FromDate $fromDate -ToDate $toDate
VERBOSE: [2025-11-13 18:33:26Z][Invoke-ApplianceLogCollection] Get health state with URI: https://169.254.53.25:9443/sysconfig/SystemReadiness
VERBOSE: [2025-11-13 18:33:26Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] Executing 'Get health state ...' with timeout 600 seconds ...
VERBOSE: [2025-11-13 18:33:26Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] [CHECK][Attempt 0] for task 'Get health state ...' ...
VERBOSE: [2025-11-13 18:33:56Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] Task 'Get health state ...' succeeded.
VERBOSE: [2025-11-13 18:33:56Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] Executing 'Get system configuration ...' with timeout 600 seconds ...
VERBOSE: [2025-11-13 18:33:56Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] [CHECK][Attempt 0] for task 'Get system configuration ...' ...
VERBOSE: [2025-11-13 18:34:37Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] Task 'Get system configuration ...' succeeded.
VERBOSE: [2025-11-13 18:34:37Z][Invoke-ApplianceLogCollection] Trigger log collections with parameters: https://169.254.53.25:9443/logs/logCollectionJob/default and body {
    "fromDate":  "2025-11-13T18:03:08.4868568Z",
    "toDate":  "2025-11-13T18:33:13.7369896Z"
}
VERBOSE: [2025-11-13 18:34:37Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] Executing 'Trigger log collection ...' with timeout 600 seconds ...
VERBOSE: [2025-11-13 18:34:37Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] [CHECK][Attempt 0] for task 'Trigger log collection ...' ...
VERBOSE: [2025-11-13 18:34:37Z][Invoke-ScriptsWithRetry][Invoke-ApplianceLogCollection] Task 'Trigger log collection ...' succeeded.
VERBOSE: [2025-11-13 18:34:37Z][Invoke-ApplianceLogCollection] Log collections trigger result: "d5cb5a24-7f35-4fdb-a0a5-f6dbab77a68c"

  6. Recopilar registros del nodo host.

    Invoke-AzureLocalDisconnectedLogCollection -FromDate (Get-Date).AddHours(-2) `
-ToDate (Get-Date) `
-AzureLocalNodeNames @("ALNode01", "ALNode02", "ALNode03") `
-AzureLocalNodeCredential (Get-Credential -UserName "Admin" -Message "Enter Azure Local node admin credentials") `
-SaveToPath "\\fileserver\logshare\AzureLocalLogs" `
-ShareCredential (Get-Credential -UserName "fileuser" -Message "Enter SMB share credentials")
-SkipAldoLogCollection

    Este comando recopila registros de nodo de host, incluidos los diagnósticos de nivel de sistema y de clúster. Para más información, consulte Invoke-AzureLocalDisconnectedLogCollection.

  7. Cargue los registros del nodo de host mediante la herramienta de observabilidad independiente y ejecute el comando . Para obtener más información, consulte Obtener soporte para problemas de implementación local de Azure.

Operaciones desconectadas para Azure Local cuando la máquina virtual del dispositivo no está conectada a Azure

En entornos de operaciones desconectados, puede recopilar registros del plano de control (dispositivo) y nodos host y, a continuación, cargarlos manualmente con una herramienta independiente.

En el diagrama siguiente se muestran los componentes clave de la recopilación de registros en operaciones desconectadas para entornos de Azure Local cuando la máquina virtual del dispositivo no está conectada a Azure.

Diagram que muestra componentes clave para un escenario de host desconectado en operaciones desconectadas para Azure Local.

Antes de recopilar registros en un escenario de operaciones desconectadas, asegúrese de:

  1. Instale el módulo de operaciones si no está instalado. Use el cmdlet y cambie la ruta de acceso para que coincida con la estructura de carpetas.

    # Replace with your actual values
Import-Module "<disconnected operations module folder path>\Azure.Local.DisconnectedOperations.psd1" -Force

    Ejemplo de resultado:

    PS C:\Users\administrator.s46r2004\Documents> Import-Module "Q:\AzureLocalVHD\OperationsModule\Azure.Local.DisconnectedOperations.psd1" -Force  
VERBOSE: [2025-03-26 19:49:12Z][Test-RunningRequirements] PSVersionTable:  

Name                           Value  
----                           -----  
PSVersion                      5.1.26100.2161  
PSEdition                      Desktop  
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}  
BuildVersion                   10.0.26100.2161  
CLRVersion                     4.0.30319.42000  
WSManStackVersion              3.0  
PSRemotingProtocolVersion      2.3  
SerializationVersion           1.1.0.1  

VERBOSE: See Readme.md for directions on how to use this module.

  2. Instale el módulo Azure Local necesario para la recopilación de registros.

    Import-Module "<Azure Local module folder path>\AzureLocal.Orchestration.psd1" -Force

    Ejemplo de resultado:

    PS C:\Users\administrator.s46r2004\Documents> Import-Module "Q:\AzureLocalVHD\Azurelocal.Orchestration\AzureLocal.Orchestration.psd1" -Force

CommandType        Name                                              Version        Source
-----------        ----                                              -------        ------
Function           Invoke-AzureLocalDisconnectedLogCollection        2602.1....    AzureLocal.Orchestration
Function           Invoke-AzureLocalEnvironmentValidation            2602.1....    AzureLocal.Orchestration

  3. Utiliza Implementación de operaciones desconectadas en Azure Local para tu endpoint de administración.

    • Identifique la dirección IP del punto de conexión de administración.

    • Identifique el certificado de cliente de administración que se usa para autenticarse con las operaciones fuera de línea del punto de conexión de administración de Azure Local.

    • Configure el contexto de cliente del punto de conexión de administración. Ejecute este script:

      # Replace with your actual values
$certPassword = Read-Host -AsSecureString "Management endpoint client certificate password"
$context = Set-DisconnectedOperationsClientContext -ManagementEndpointClientCertificatePath "<Management Endpoint Client Cert Path>" -ManagementEndpointClientCertificatePassword $certPassword -ManagementEndpointIpAddress "<Management Endpoint IP address>"

  4. Cree una compartición. Ejecute este comando:

    New-SMBShare -Name `<share-name>` -Path `<path-to-share>` -FullAccess Users -ChangeAccess 'Server Operators'

  5. Configure las credenciales para el recurso compartido. Reemplace el texto del marcador de posición y por sus propios valores y, a continuación, ejecute este comando:

    # Replace with your actual values
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)

  6. Recopilar registros del plano de control y del nodo host. Ejecute este comando en un sistema que pueda acceder a la máquina virtual del dispositivo (normalmente el mismo host de Hyper-V):

    Ejemplo:

    #replace with your actual values
Invoke-AzureLocalDisconnectedLogCollection -FromDate (Get-Date).AddHours(-2) `
-ToDate (Get-Date) `
-AzureLocalNodeNames @("ALNode01", "ALNode02", "ALNode03") `
-AzureLocalNodeCredential (Get-Credential -UserName "Admin" -Message "Enter Azure Local node admin credentials") `
-SaveToPath "\\fileserver\logshare\AzureLocalLogs" `
-ShareCredential (Get-Credential -UserName "fileuser" -Message "Enter SMB share credentials")

    Este comando también incluye diagnósticos de nivel de sistema y de clúster. Para más información, consulte Invoke-AzureLocalDisconnectedLogCollection.

  7. Después de la recopilación, revise los registros localmente o cárguelos en Microsoft mediante la herramienta de observabilidad independiente. Hay contenedores específicos del producto alrededor de Microsoft.AzureStack.Observability.Standalone.

    Al recopilar registros mediante , los registros de los nodos host y del dispositivo se guardan en subcarpetas separadas dentro de la misma ubicación.

    Nota:

    Es necesario cargar estos cmdlets usando diferentes cmdlets.

    Ubicaciones de archivos de registro y comandos de carga:

    • Registros del dispositivo:

      # Logs from disconnected operations appliance for Azure Local infrastructure

<SaveToPath>\ALDO

      Cargue los registros recopilados de la máquina virtual del dispositivo mediante el cmdlet Send-DiagnosticData del módulo de PowerShell en operaciones desconectadas para Azure Local.

    • Registros de nodos huésped (nodos de clúster):

      # Logs from Azure Local host nodes

<SaveToPath>\AzureLocal

      Cargue los registros recopilados de los nodos de host de Azure Local mediante el cmdlet Send-AzStackHciDiagnosticData. Para obtener más información, consulte Obtener soporte para problemas de implementación local de Azure.

  8. Opcional. Si se produce un error en el comando o se interrumpe, use el cmdlet .

Métodos de recopilación de registros

Colección directa (conectada a Azure)

Cuando el dispositivo pueda conectarse a Azure y el punto de conexión de administración sea accesible, use el cmdlet Invoke-ApplianceLogCollection.

El cmdlet le permite especificar un intervalo de tiempo para la recopilación de registros. Ejecute este cmdlet desde un host que tenga importado el módulo de PowerShell necesario y que pueda acceder al punto de conexión de administración del dispositivo.

Para obtener más información, consulte Operaciones desconectadas para Azure Local cuando la máquina virtual de la solución está conectada a Azure.

Recopilación indirecta (desconectada de Azure, punto de conexión accesible)

Cuando la appliance no se puede conectar a Azure, pero puede acceder al punto de conexión de administración, use el cmdlet Invoke-AzureLocalDisconnectedLogCollection. A continuación, cargue los registros con el cmdlet .

Para obtener más información, consulte Operaciones desconectadas para Azure Local cuando la máquina virtual del dispositivo no está conectada a Azure.

Recopilación de reserva (punto de conexión no accesible, máquina virtual del dispositivo inactiva)

Cuando el punto de conexión de administración no está disponible o la máquina virtual del dispositivo está sin conexión:

  • Apague la máquina virtual del appliance, monte y desbloquee los discos duros virtuales, y copie los registros usando el cmdlet .
  • Cargue los registros manualmente con cmdlet.

Para obtener más información acerca de la recopilación de respaldo, consulte Recopilación de registros de respaldo del dispositivo para operaciones desconectadas.

Invoke-AzureLocalDisconnectedLogCollection

Cuando el dispositivo de máquina virtual está conectado, este comando recopila todos los registros del nodo host. Cuando se desconecta, recopila registros del nodo host y del dispositivo de máquina virtual.

Este cmdlet:

  • Está disponible cuando se instala la extensión de telemetría y diagnósticos.
  • Proporciona datos de diagnóstico detallados para ayudarle a solucionar problemas.

Capacidades:

  • Recopila registros adicionales y específicos del rol y registros opcionales del Centro de datos definidos por software.
  • Filtra los registros por rol, intervalo de fechas o tipo de registro.
  • Solo se ejecuta en el nodo donde se ejecuta el comando y se omiten los agentes de observabilidad.
  • Guarda los registros localmente solo cuando se usa el parámetro .
    • Los registros del dispositivo se guardan en .
    • Los registros del nodo de host se guardan en .
  • Usa el parámetro SkipAldoLogCollection para recopilar registros solo de nodos host de Azure Local y omitir el plano de control de operaciones desconectado.
  • Admite credenciales seguras para guardar registros en un recurso compartido de red.

Enviar-DatosDiagnósticos

El cmdlet le permite enviar registros al soporte técnico de Microsoft a través de la canalización independiente.

Este cmdlet requiere:

  • Detalles de la suscripción: ResourceGroupName, SubscriptionId, TenantId y RegistrationRegion.
  • Credenciales: mediante el inicio de sesión manual o proporcionando la principal de servicio adecuada y la contraseña.
  • Realiza automáticamente la desinstalación y la limpieza de artefacto al tener éxito.

Revise la sección Configuración de la observabilidad para diagnósticos y soporte para ver los pasos necesarios para crear el grupo de recursos y el principal de servicio necesarios para cargar los registros.

La canalización independiente:

  • Conecta la máquina host a Azure.
  • Tiene como destino todos los registros de una carpeta proporcionada.
  • Los carga al soporte técnico de Microsoft.
    • Si se produce un error en la carga, el cmdlet intenta hasta tres veces y muestra los resultados cuando finaliza.

Nota:

Ejecute Send-DiagnosticData en una máquina Windows conectada a Internet.

  • No puede ejecutar este cmdlet en hosts de Azure Local porque no pueden usar Azure como plano de control de Arc cuando se configuran las operaciones desconectadas.
  • Al ejecutar el cmdlet , la máquina usa el registro de Arc para cargar datos en el soporte técnico de Microsoft.
    • RegistrationRegion es el mismo que Location en .

Use este método cuando no pueda recopilar registros directamente desde la máquina virtual del dispositivo, por ejemplo:

  • La máquina virtual del dispositivo está desconectada de Azure.
  • No se puede acceder al punto de conexión de administración.

ejemplos de cmdlets de Send-DiagnosticData

Estos son algunos ejemplos de cómo usar el cmdlet .

  • Para importar el módulo, ejecute este comando:

    Import-Module "<disconnected operations module folder path>" -Force
Send-DiagnosticData -ResourceGroupName <String> -SubscriptionId <String> -TenantId <String> [-RegistrationWithDeviceCode] -RegistrationRegion <String> [-Cloud <String>] -DiagnosticLogPath <String> [-ObsRootFolderPath <String>] [-StampId <Guid>] [<CommonParameters>]

  • Para iniciar sesión manualmente mediante un código de dispositivo, ejecute este comando:

    Send-DiagnosticData -ResourceGroupName <String> -SubscriptionId <String> -TenantId <String> [-RegistrationWithDeviceCode] -RegistrationRegion <String> [-Cloud <String>] -DiagnosticLogPath <String> [-ObsRootFolderPath <String>] [-StampId <Guid>] [<CommonParameters>]

  • Para usar credenciales de principal de servicio, ejecute este comando:

    Send-DiagnosticData -ResourceGroupName <String> -SubscriptionId <String> -TenantId <String> -RegistrationWithCredential <PSCredential> -RegistrationRegion <String> [-Cloud <String>] -DiagnosticLogPath <String> [-ObsRootFolderPath <String>] [-StampId <Guid>] [<CommonParameters>]

Clear-DiagnosticPipeline

Si se produce un error en la ejecución o se interrumpe debido a una instalación parcial, una instalación no limpia o la cancelación de Ctrl+C, use el cmdlet para limpiar o quitar la canalización.

Este cmdlet:

  • Solo es necesario cuando se produce un error en la limpieza automática o se interrumpe.
  • Usa el mismo método de autenticación que la llamada original para la desinstalación.

Nota:

Si tiene un agente de Arc for Server conectado antes de ejecutar , use el parámetro para conservar la conexión de Arc preexistente.

ejemplos de cmdlets de Clear-DiagnosticPipeline

Métodos de autenticación admitidos:

  • Autenticación de código de dispositivo:

    Clear-DiagnosticPipeline `
    -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
    -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

  • PassThrough mediante el contexto de Azure existente:

    Clear-DiagnosticPipeline -PassThrough

  • Credenciales de entidad de servicio:

    Clear-DiagnosticPipeline -RegistrationWithCredential $credential

Opciones disponibles:

  • Conservar la conexión del agente de Arc preexistente:

    Clear-DiagnosticPipeline `
    -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
    -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" `
    -SkipArcForServer

  • Omita la desinstalación y elimine los artefactos residuales. La autenticación no es necesaria porque no se inicia ninguna desinstalación:

    Clear-DiagnosticPipeline -SkipUninstall

Supervisión de la recopilación de registros

Use estos comandos para supervisar la recopilación de registros.

Get-ApplianceLogCollectionJobStatus

Compruebe el estado del trabajo de recopilación de registros con este cmdlet.

Get-ApplianceLogCollectionJobStatus -OperationId $OperationId

Ejemplo de resultado:

   PS C:\Users\administrator.s46r2004\Documents> Get-ApplianceLogCollectionJobStatus -OperationId $operationId  
   VERBOSE: [2023-04-09 22:35:29Z] [Invoke-ScriptsWithRetry] Executing 'Get log collection job status ...' with timeout 600 seconds ...  
   VERBOSE: [2023-04-09 22:35:29Z] [Invoke-ScriptsWithRetry] [CHECK] [Attempt 0] for task 'Get log collection job status ...' ...  
   VERBOSE: [2023-04-09 22:35:29Z] [Invoke-ScriptsWithRetry] Task 'Get log collection job status ...' succeeded.  

   StatusRecord                               
   @{Instance Id=<Instance Id>; State=Running; StartTime=0001-01-01T00:00:00; EndTime=0001-01-01T00:00:00}

Obtener histórico de colección de registros de dispositivos (Get-ApplianceLogCollectionHistory)

Obtenga el historial de recopilación de registros con este cmdlet. El parámetro de entrada toma el tipo DateTime y establece la hora de inicio de la ventana de búsqueda del historial. Si no especifica el , el cmdlet busca en las últimas tres horas.

   Get-ApplianceLogCollectionHistory -FromDate ((Get-Date).AddHours(-5))

Ejemplo de resultado:

PS G:\azurelocal\OperationsModule> Get-ApplianceLogCollectionHistory -FromDate ((Get-Date).AddHours(-5))
VERBOSE: [2025-10-17 05:16:14Z][Invoke-ScriptsWithRetry][Get-ApplianceLogCollectionHistory] Executing 'Get log collection job history ...' with timeout 600 seconds ...
VERBOSE: [2025-10-17 05:16:14Z][Invoke-ScriptsWithRetry][Get-ApplianceLogCollectionHistory] [CHECK][Attempt 0] for task 'Get log collection job history ...' ...
VERBOSE: [2025-10-17 05:16:14Z][Invoke-ScriptsWithRetry][Get-ApplianceLogCollectionHistory] Task 'Get log collection job history ...' succeeded.


Name              : b4cffa08-6eb8-4700-a29e-6b5f08824c87
OperationId       : b4cffa08-6eb8-4700-a29e-6b5f08824c87
CorrelationId     : aaaa0000-bb11-2222-33cc-444444dddddd
State             : Succeeded
CollectionTime    : 2025-10-17T01:13:00.273+00:00
CollectionEndTime : 2025-10-17T02:07:52.069+00:00
FromDate          : 2025-10-17T00:39:40.448+00:00
ToDate            : 2025-10-17T01:09:40.453+00:00
Distributed       : True
JobType           : OnDemand
StorageKind       : Azure
Reason            : User initiated
Error             : @{Code=0}
UploadDetails     : @{UploadStartTime=2025-10-17T01:13:00.273+00:00; UploadSizeInMb=6982; UploadNumberOfFiles=710}

Get-ApplianceInstanceConfiguration

Obtenga la configuración de la instancia del dispositivo, incluido el identificador de marca y el identificador de recurso (DeviceARMResourceUri), con este cmdlet.

   $stampId = (Get-ApplianceInstanceConfiguration).StampId

Ejemplo de resultado:

    PS G:\azurelocal\> Get-ApplianceInstanceConfiguration
    VERBOSE: [2025-08-06 00:00:35Z][Invoke-ScriptsWithRetry][Get-ApplianceInstanceConfiguration] Executing 'Retrieving system configuration ...' with timeout 300 seconds ...
    VERBOSE: [2025-08-06 00:00:35Z][Invoke-ScriptsWithRetry][Get-ApplianceInstanceConfiguration] [CHECK][Attempt 0] for task 'Retrieving system configuration ...' ...
    VERBOSE: [2025-08-06 00:00:35Z][`ScriptBlock`] Getting system configuration from https://</IP address>:9443/sysconfig/SystemConfiguration
    VERBOSE: [2025-08-06 00:00:35Z][Invoke-ScriptsWithRetry][Get-ApplianceInstanceConfiguration] Task 'Retrieving system configuration ...' succeeded.


    IsAutomaticUpdatePreparation :
    ExternalTimeServers          :
    IsTelemetryOptOut            : False
    ExternalDomainSuffix         : autonomous.cloud.private
    ImageVersion                 : 7.1064750419.18210
    IngressNICPrefixLength       : 24
    DeviceARMResourceUri         : /subscriptions/<Subcription ID>/resourceGroups/<Resource group>/providers/Microsoft.Edge/winfields/7dfd0b
    ConnectionIntent             : Connected
    StampId                      : <Stamp ID>
    IngressNICIPAddress          : 10.0.50.4
    DnsForwarderIpAddress        : 10.10.240.23
    IngressNICDefaultGateway     : 10.0.50.1

Consideraciones de seguridad

Cuando recopile registros de diagnóstico en entornos aislados, debe comprender las protecciones de seguridad y privacidad integradas en este proceso. Las consideraciones siguientes ayudan a asegurarse de que los datos de diagnóstico permanecen seguros al mismo tiempo que proporcionan a Microsoft la información necesaria para obtener soporte técnico eficaz.

  • En entornos aislados por aire, use este método para obtener y proporcionar logs de diagnóstico a Microsoft.
  • Los registros no se envían automáticamente a menos que se establezcan claramente para que se envíen.
  • Los registros se pueden guardar localmente y revisar antes de compartirlos.
  • Los registros pueden contener metadatos operativos confidenciales, pero no incluyen datos personales de forma predeterminada.
  • Microsoft no mantiene el acceso a los registros a menos que los clientes los compartan directamente.

Si su organización impide que el nodo afectado se conecte directamente a Internet, siga estos pasos:

  1. Para almacenar los registros localmente, use la opción .
  2. Mueva los registros a una máquina virtual o sistema independiente que pueda conectarse a Internet.
  3. Para cargar registros en Microsoft a través de canales de soporte técnico seguros, use ese sistema.

Problemas comunes

  • Formato de cuenta para el cobro indirecto:

    • Use Domain\Username al ejecutar .
    • Si omite el dominio o usa un nombre de usuario incorrecto, la operación de copia en el recurso compartido falla con un error de acceso denegado.

  • Ejecución de Send-DiagnosticData:

    • Debe ejecutarse en una máquina Windows que tenga acceso directo a Internet a Azure.
    • No se ejecute en sistemas habilitados para Arc ni en el dispositivo que actúa como plano de control de Arc.

  • Ejecución de Copy-DiagnosticData:

    • Debe ejecutarse en el host de Hyper-V que hospeda la máquina virtual desconectada Azure Local.

  • Requisitos de rol:

    • Los roles necesarios varían según el escenario.
    • Para determinar los roles adecuados, use el cmdlet o trabaje con el contacto de soporte técnico.

  • Ejecución incorrecta de comandos:

    • Se produce un error en la recopilación de registros si los comandos se ejecutan desde:
      • Nodos que no forman parte de la infraestructura de host de Azure Local.
      • Máquinas externas (por ejemplo, portátiles personales) que no hospedan las máquinas virtuales del dispositivo necesarias en el mismo host de Hyper-V.

  • Uso de herramientas de observabilidad:

    • Ejecute la herramienta de observabilidad independiente en Windows Server.
    • Los entornos no admitidos requieren una configuración manual adicional.

Características no admitidas en modo desconectado

Estas características no se admiten en modo desconectado.

  • Compatibilidad remota.
  • Recopilación de registros basada en el portal.
  • Métricas y streaming de telemetría.

Contenido relacionado

  • Obtenga información sobre cómo y cuándo usar la recopilación de registros de respaldo del dispositivo.

Esta característica solo está disponible en Azure Local 2602 o posterior.

  • Last updated on