Invoke-AzOperationalInsightsQuery
Retorna resultados de pesquisa com base nos parâmetros especificados.
Sintaxe
ByWorkspaceId (Predefinição)
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
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 .
Nota: tente definir -Wait para um valor maior se ocorrer o erro "A solicitação foi cancelada devido ao HttpClient.Timeout configurado de 100 segundos decorridos".
Exemplos
Exemplo 1: Obter resultados da pesquisa usando uma consulta
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results
Uma vez 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 no retorno de conjuntos de dados muito grandes. Por 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 durante 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
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-IncludeRender
Se especificado, as informações de renderização para consultas métricas serão incluídas na resposta.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-IncludeStatistics
Se especificado, as estatísticas de consulta serão incluídas na resposta.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Query
A consulta a ser executada.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Timespan
O período de tempo para vincular a consulta.
Propriedades dos parâmetros
Tipo: Nullable<T> [ TimeSpan ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Wait
Coloca um limite superior na quantidade de tempo que o servidor gastará processando a consulta. Veja: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Workspace
O espaço de trabalho
Propriedades dos parâmetros
Tipo: PSWorkspace
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ByWorkspaceObject
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-WorkspaceId
O ID do espaço de trabalho.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ByWorkspaceId
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas