Invoke-AzOperationalInsightsQuery
Gibt Suchergebnisse basierend auf den angegebenen Parametern zurück.
Syntax
ByWorkspaceId (Standard)
Invoke-AzOperationalInsightsQuery
-WorkspaceId <String>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByWorkspaceObject
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: .
Hinweis: Versuchen Sie, die Einstellung 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
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-IncludeRender
Wenn angegeben, werden Renderinginformationen für Metrikabfragen in die Antwort eingeschlossen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-IncludeStatistics
Wenn angegeben, werden Abfragestatistiken in die Antwort einbezogen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Query
Die auszuführende Abfrage.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Timespan
Der Zeitbereich, an den die Abfrage gebunden werden soll.
Parametereigenschaften
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Wait
Legt eine obere Grenze an die Zeitspanne, die der Server für die Verarbeitung der Abfrage aufwendet. Siehe:
Parametereigenschaften
Typ: Nullable<T> [ Int32 ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Workspace
Der Arbeitsbereich
Parametereigenschaften
Typ: PSWorkspace
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
ByWorkspaceObject
Position: Named Obligatorisch: True Wert aus Pipeline: True Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-WorkspaceId
Die Arbeitsbereichs-ID.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
ByWorkspaceId
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben