Invoke-AzOperationalInsightsQuery

Devuelve los resultados de búsqueda en función de los parámetros especificados.

Syntax

Invoke-AzOperationalInsightsQuery
      -WorkspaceId <String>
      -Query <String>
      [-Timespan <TimeSpan>]
      [-Wait <Int32>]
      [-IncludeRender]
      [-IncludeStatistics]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Invoke-AzOperationalInsightsQuery
      -Workspace <PSWorkspace>
      -Query <String>
      [-Timespan <TimeSpan>]
      [-Wait <Int32>]
      [-IncludeRender]
      [-IncludeStatistics]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Description

El cmdlet Invoke-AzOperational Ideas Query devuelve los resultados de la búsqueda en función de los parámetros especificados. Puede acceder al estado de la búsqueda en la propiedad Metadata del objeto devuelto. Si el estado es Pendiente, la búsqueda no se ha completado y los resultados serán del archivo. Puede recuperar los resultados de la búsqueda de la propiedad Value del objeto devuelto. Consulte los detalles de los límites generales de las consultas aquí: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Ejemplos

Ejemplo 1: Obtención de resultados de búsqueda mediante una consulta

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results

Una vez invocado, $queryResults.Results contendrá todas las filas resultantes de la consulta.

Ejemplo 2: Convertir $results. Resultado IEnumerable en una matriz

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)

Algunas consultas pueden dar lugar a que se devuelvan conjuntos de datos muy grandes. Debido a esto, el comportamiento predeterminado del cmdlet es devolver un IEnumerable para reducir los costos de memoria. Si prefiere tener una matriz de resultados, puede usar el método de extensión LINQ Enumerable.ToArray() para convertir IEnumerable en una matriz.

Ejemplo 3: Obtención de resultados de búsqueda mediante una consulta en un período de tiempo específico

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results

Los resultados de esta consulta se limitarán a las últimas 24 horas.

Ejemplo 4: Incluir representación y estadísticas en el resultado de la consulta

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results

$queryResults.Render

$queryResults.Statistics

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeRender

Si se especifica, la información de representación de las consultas de métricas se incluirá en la respuesta.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeStatistics

Si se especifica, las estadísticas de consulta se incluirán en la respuesta.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Query

Consulta que se va a ejecutar.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Timespan

Intervalo de tiempo por el que se enlaza la consulta.

Type:Nullable<T>[TimeSpan]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Wait

Coloca un límite superior en la cantidad de tiempo que el servidor dedicará a procesar la consulta.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Workspace

El área de trabajo

Type:PSWorkspace
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WorkspaceId

El identificador del área de trabajo.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSWorkspace

Salidas

PSQueryResponse