Sdílet prostřednictvím


Invoke-AzOperationalInsightsQuery

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