Invoke-AzOperationalInsightsQuery
Vrátí výsledky hledání na základě zadaných parametrů.
Syntax
ByWorkspaceId (Výchozí)
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>]
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í
Vlastnosti parametru
Typ: SwitchParameter
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Vlastnosti parametru
Typ: IAzureContextContainer
Default value: None Podporuje zástupné znaky: False DontShow: False Aliasy: AzContext, AzureRmContext, AzureCredential
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-IncludeRender
Pokud je zadáno, do odpovědi se zahrnou informace o vykreslování pro dotazy na metriky.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-IncludeStatistics
Pokud zadáte, do odpovědi se zahrnou statistiky dotazu.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-Query
Dotaz, který se má provést.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: True Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-Timespan
Časový rozsah pro vazbu dotazu.
Vlastnosti parametru
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: 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
Vlastnosti parametru
Typ: Nullable<T> [ Int32 ]
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-Workspace
Pracovní prostor
Vlastnosti parametru
Typ: PSWorkspace
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
ByWorkspaceObject
Position: Named Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-WorkspaceId
Identifikátor pracovního prostoru.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
ByWorkspaceId
Position: Named Povinné: True Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters .
Výstupy
