Invoke-AzOperationalInsightsQuery
Retorna resultados de pesquisa com base nos parâmetros especificados.
Sintaxe
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.
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
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IncludeRender
Se especificado, as informações de renderização para consultas métricas serão incluídas na resposta.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IncludeStatistics
Se especificado, as estatísticas de consulta serão incluídas na resposta.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Query
A consulta a ser executada.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Timespan
O período de tempo para vincular a consulta.
Tipo: | Nullable<T>[TimeSpan] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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
Tipo: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Workspace
O espaço de trabalho
Tipo: | PSWorkspace |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-WorkspaceId
O ID do espaço de trabalho.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
Saídas
Azure PowerShell