Invoke-AzOperationalInsightsQuery

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.

Hinweis: Versuchen Sie, die Einstellung -Wait auf einen größeren Wert festzulegen, wenn der Fehler "Die Anforderung wurde aufgrund des konfigurierten HttpClient.Timeouts von 100 Sekunden Elapsing abgebrochen".

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IncludeRender

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IncludeStatistics

Wenn angegeben, werden Abfragestatistiken in die Antwort einbezogen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Query

Die auszuführende Abfrage.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Timespan

Der Zeitbereich, an den die Abfrage gebunden werden soll.

Typ:	Nullable<T>[TimeSpan]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Wait

Legt eine obere Grenze an die Zeitspanne, die der Server für die Verarbeitung der Abfrage aufwendet. Siehe: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Workspace

Der Arbeitsbereich

Typ:	PSWorkspace
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WorkspaceId

Arbeitsbereich-ID.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PSWorkspace

Ausgaben

PSQueryResponse