Invoke-AzOperationalInsightsQuery

Referência

Módulo:: Az.OperationalInsights

Retorna resultados de pesquisa com base nos 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

O cmdlet Invoke-AzOperationalInsightsQuery retorna os resultados da pesquisa com base nos parâmetros especificados. Você pode acessar o status da pesquisa na propriedade Metadata do objeto retornado. Se o status for Pendente, a pesquisa não foi concluída e os resultados serão do arquivo. Você pode recuperar os resultados da pesquisa da propriedade Value do objeto retornado. Por favor, verifique os detalhes dos limites gerais de consulta aqui: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Exemplos

Exemplo 1: Obter resultados de pesquisa usando uma consulta

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

Depois de invocado, $queryResults.Results conterá todas as linhas resultantes da sua consulta.

Exemplo 2: Converter $results. Resultado: IEnumerable para uma matriz

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

Algumas consultas podem resultar em conjuntos de dados muito grandes sendo retornados. Devido a isso, o comportamento padrão do cmdlet é retornar um IEnumerable para reduzir os custos de memória. Se preferir ter uma matriz de resultados, você pode usar o método de extensão LINQ Enumerable.ToArray() para converter o IEnumerable em uma matriz.

Exemplo 3: Obter resultados de pesquisa usando uma consulta em um período de tempo específico

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

Os resultados desta consulta serão limitados às últimas 24 horas.

Exemplo 4: Incluir estatísticas de renderização & no resultado da 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

Executar cmdlet em segundo plano

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

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

-IncludeRender

Se especificado, as informações de renderização para consultas de métrica serão incluídas na resposta.

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

-IncludeStatistics

Se especificado, as estatísticas de consulta serão incluídas na resposta.

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

-Query

A consulta a ser executada.

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

-Timespan

O período de tempo para vincular a consulta por.

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

-Wait

Coloca um limite superior na quantidade de tempo que o servidor gastará processando a consulta.

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

-Workspace

O espaço de trabalho

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

-WorkspaceId

A ID do workspace.

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

Entradas

PSWorkspace

Saídas

PSQueryResponse