Invoke-AzOperationalInsightsQuery

Reference

Modul:: Az.OperationalInsights

Vrátí výsledky hledání na základě zadaných parametrů.

Syntaxe

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

Description

Rutina Invoke-AzOperationalInsightsQuery vrátí výsledky hledání na základě zadaných parametrů. Ke stavu vyhledávání se dostanete ve vlastnosti Metadata vráceného objektu. Pokud je stav Čeká na vyřízení, hledání se nedokončilo a výsledky budou z archivu. Výsledky hledání můžete načíst z vlastnosti Value vráceného objektu. Podrobnosti o obecných omezeních dotazů najdete tady: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Poznámka: Zkuste nastavit -Wait větší hodnotu, pokud dojde k chybě Požadavek byl zrušen z důvodu nakonfigurovaného HttpClient.Timeout 100 sekund uplynula.

Příklady

Příklad 1: Získání výsledků hledání pomocí dotazu

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

Po vyvolání bude $queryResults.Results obsahovat všechny výsledné řádky z dotazu.

Příklad 2: Převod $results Výsledek IEnumerable pro pole

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

Některé dotazy můžou způsobit vrácení velmi velkých datových sad. Z tohoto důvodu je výchozím chováním rutiny vrácení IEnumerable ke snížení nákladů na paměť. Pokud chcete mít pole výsledků, můžete použít LINQ Enumerable.ToArray() rozšiřující metodu převést IEnumerable na pole.

Příklad 3: Získání výsledků hledání pomocí dotazu v určitém časovém rámci

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

Výsledky tohoto dotazu budou omezené na posledních 24 hodin.

Příklad 4: Zahrnutí vykreslení a statistiky ve výsledku dotazu

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

$queryResults.Render

$queryResults.Statistics

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IncludeRender

Pokud je zadáno, do odpovědi se zahrnou informace o vykreslování pro dotazy na metriky.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IncludeStatistics

Pokud zadáte, do odpovědi se zahrnou statistiky dotazu.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Query

Dotaz, který se má provést.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Timespan

Časový rozsah pro vazbu dotazu.

Typ:	Nullable<T>[TimeSpan]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Wait

Umístí horní mez doby, po kterou bude server strávit zpracováním dotazu. Viz: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Workspace

U pracovního prostoru

Typ:	PSWorkspace
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WorkspaceId

ID pracovního prostoru.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

PSWorkspace

Výstupy

PSQueryResponse

Sdílet prostřednictvím