Compartir a través de

Invoke-AzOperationalInsightsQuery

Módulo:
Az.OperationalInsights Module

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

Sintaxis

ByWorkspaceId (valor predeterminado) 

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

ByWorkspaceObject 

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeRender

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeStatistics

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Query

Consulta que se va a ejecutar.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Timespan

Intervalo de tiempo por el que se enlaza la consulta.

Propiedades de parámetro

Tipo:

Nullable<T>[TimeSpan]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Workspace

Área de trabajo

Propiedades de parámetro

Tipo:PSWorkspace
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByWorkspaceObject
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkspaceId

El identificador del área de trabajo.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByWorkspaceId
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSWorkspace

Salidas

PSQueryResponse