Invoke-AzOperationalInsightsQuery

Referenz

Modul:: Az.OperationalInsights

Gibt Suchergebnisse basierend auf den angegebenen Parametern zurück.

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

Beschreibung

Das Cmdlet Invoke-AzOperationalInsightsQuery gibt die Suchergebnisse basierend auf den angegebenen Parametern zurück. Sie können auf den Status der Suche in der Metadata-Eigenschaft des zurückgegebenen Objekts zugreifen. Wenn der Status ausstehend ist, wurde die Suche nicht abgeschlossen, und die Ergebnisse stammen aus dem Archiv. Sie können die Ergebnisse der Suche aus der Value-Eigenschaft des zurückgegebenen Objekts abrufen. Details zu allgemeinen Abfragegrenzwerten finden Sie hier: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Beispiele

Beispiel 1: Abrufen von Suchergebnissen mithilfe einer Abfrage

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

Nach dem Aufrufen enthält $queryResults.Results alle resultierenden Zeilen aus Ihrer Abfrage.

Beispiel 2: Konvertieren $results. Ergebnis-IEnumerable für ein Array

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

Einige Abfragen können dazu führen, dass sehr große Datasets zurückgegeben werden. Aus diesem Grund besteht das Standardverhalten des Cmdlets darin, eine IEnumerable zurückzugeben, um die Speicherkosten zu reduzieren. Wenn Sie ein Array von Ergebnissen bevorzugen, können Sie die LINQ Enumerable.ToArray()-Erweiterungsmethode verwenden, um die IEnumerable-Methode in ein Array zu konvertieren.

Beispiel 3: Abrufen von Suchergebnissen mithilfe einer Abfrage über einen bestimmten Zeitrahmen

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

Die Ergebnisse dieser Abfrage sind auf die letzten 24 Stunden beschränkt.

Beispiel 4: Rendern und Statistiken in das Abfrageergebnis einschließen

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

$queryResults.Render

$queryResults.Statistics

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-IncludeRender

Wenn angegeben, werden Renderinginformationen für Metrikabfragen in die Antwort eingeschlossen.

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

-IncludeStatistics

Wenn angegeben, werden Abfragestatistiken in die Antwort einbezogen.

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

-Query

Die auszuführende Abfrage.

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

-Timespan

Der Zeitbereich, an den die Abfrage gebunden werden soll.

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

-Wait

Legt eine obere Grenze an die Zeitspanne, die der Server für die Verarbeitung der Abfrage aufwendet.

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

-Workspace

Der Arbeitsbereich

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

-WorkspaceId

Arbeitsbereich-ID.

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

Eingaben

PSWorkspace

Ausgaben

PSQueryResponse