Invoke-AzOperationalInsightsQuery

Módulo:

Az.OperationalInsights

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

Sintaxis

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-AzOperationalInsightsQuery devuelve los resultados de 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.

Nota: intente establecer -Wait en un valor mayor si experimenta el error "La solicitud se canceló debido al tiempo de espera httpClient.Timeout configurado de 100 segundos transcurrido".

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IncludeRender

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IncludeStatistics

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Query

Consulta que se va a ejecutar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Timespan

Intervalo de tiempo por el que se enlaza la consulta.

Tipo:	Nullable<T>[TimeSpan]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Wait

Coloca un límite superior en la cantidad de tiempo que el servidor dedicará a procesar la consulta. Consulte: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Tipo:	Nullable<T>[Int32]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Workspace

El área de trabajo

Tipo:	PSWorkspace
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WorkspaceId

El identificador del área de trabajo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

PSWorkspace

Salidas

PSQueryResponse