Invoke-AzOperationalInsightsQuery

Restituisce i risultati della ricerca in base ai parametri specificati.

Sintassi

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>]

Descrizione

Il cmdlet Invoke-AzOperationalInsightsQuery restituisce i risultati della ricerca in base ai parametri specificati. È possibile accedere allo stato della ricerca nella proprietà Metadata dell'oggetto restituito. Se lo stato è In sospeso, la ricerca non è stata completata e i risultati provengono dall'archivio. È possibile recuperare i risultati della ricerca dalla proprietà Value dell'oggetto restituito. Controllare i dettagli dei limiti generali delle query qui: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Esempio

Esempio 1: Ottenere i risultati della ricerca usando una query

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

Una volta richiamato, $queryResults.Results conterrà tutte le righe risultanti dalla query.

Esempio 2: Convertire $results. Risultato IEnumerable in una matrice

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

Alcune query possono comportare la restituzione di set di dati di grandi dimensioni. Per questo motivo, il comportamento predefinito del cmdlet consiste nel restituire un IEnumerable per ridurre i costi di memoria. Se si preferisce avere una matrice di risultati, è possibile usare il metodo di estensione LINQ Enumerable.ToArray() per convertire IEnumerable in una matrice.

Esempio 3: Ottenere i risultati della ricerca usando una query in un intervallo di tempo specifico

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

I risultati di questa query saranno limitati alle ultime 24 ore.

Esempio 4: Includere rendering e statistiche nel risultato della query

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

$queryResults.Render

$queryResults.Statistics

Parametri

-AsJob

Eseguire il cmdlet in background

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-IncludeRender

Se specificato, le informazioni di rendering per le query sulle metriche verranno incluse nella risposta.

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

-IncludeStatistics

Se specificato, le statistiche delle query verranno incluse nella risposta.

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

-Query

Query da eseguire.

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

-Timespan

Intervallo di tempo in base al quale associare la query.

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

-Wait

Imposta un limite superiore sulla quantità di tempo che il server spenderà per l'elaborazione della query.

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

-Workspace

L'area di lavoro

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

-WorkspaceId

ID dell'area di lavoro.

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

Input

PSWorkspace

Output

PSQueryResponse