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 saranno dall'archivio. È possibile recuperare i risultati della ricerca dalla proprietà Value dell'oggetto restituito. Controllare i dettagli dei limiti generali delle query qui: https://docs.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Esempio

Esempio 1: Ottenere i risultati della ricerca usando una query

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

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

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

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

Alcune query possono comportare la restituzione di set di dati molto grandi. A causa di questo, il comportamento predefinito del cmdlet consiste nel restituire un oggetto 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

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

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

Esempio 4: Includere le statistiche di rendering & nel risultato della query

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

$queryResults.Render

$queryResults.Statistics

Per informazioni dettagliate sul rendering e sulle informazioni sulle statistiche, vedere https://dev.loganalytics.io/documentation/Using-the-API/RequestOptions informazioni dettagliate.

Parametri

-AsJob

Eseguire il cmdlet in background

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

Le credenziali, l'account, il tenant e la sottoscrizione usati per la comunicazione con Azure.

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

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

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

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

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

Query da eseguire.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Timespan

Intervallo di tempo per associare la query in base.

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

Inserisce un limite superiore sulla quantità di tempo in cui il server spenderà l'elaborazione della query. Vedere: https://dev.loganalytics.io/documentation/Using-the-API/Timeouts

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

L'area di lavoro

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

ID area di lavoro.

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

Input

PSWorkspace

Output

PSQueryResponse