Invoke-AzureRmOperationalInsightsQuery
Vrátí výsledky hledání na základě zadaných parametrů.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntax
Invoke-AzureRmOperationalInsightsQuery
-WorkspaceId <String>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Invoke-AzureRmOperationalInsightsQuery
-Workspace <PSWorkspace>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Rutina Invoke-AzureRmOperational Přehledy Query 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.
Příklady
Příklad 1: Získání výsledků hledání pomocí dotazu
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10"
PS C:\> $queryResults.Results
...Po vyvolání bude $queryResults.Results obsahovat všechny výsledné řádky z dotazu.
Příklad 2: Převod $results Výsledek IEčíslovatelné pro pole
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10"
PS C:\> $resultsArray = [System.Linq.Enumerable]::ToArray($results.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
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10" -Timespan (New-TimeSpan -Hours 24)
PS C:\> $queryResults.Results
...Výsledky tohoto dotazu budou omezené na posledních 24 hodin.
Příklad 4: Zahrnutí vykreslení a statistiky ve výsledku dotazu
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10" -IncludeRender -IncludeStatistics
PS C:\> $queryResults.Results
...
PS C:\> $queryResults.Render
...
PS C:\> $queryResults.Statistics
...Parametry
-AsJob
Spuštění rutiny na pozadí
| Typ: | SwitchParameter |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
| Typ: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeRender
Pokud je zadáno, do odpovědi se zahrnou informace o vykreslování pro dotazy na metriky.
| Typ: | SwitchParameter |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeStatistics
Pokud zadáte, do odpovědi se zahrnou statistiky dotazu.
| Typ: | SwitchParameter |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Query
Dotaz, který se má provést.
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Timespan
Časový rozsah pro vazbu dotazu.
| Typ: | Nullable<T>[TimeSpan] |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Umístí horní mez doby, po kterou bude server strávit zpracováním dotazu.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Workspace
U pracovního prostoru
| Typ: | PSWorkspace |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WorkspaceId
ID pracovního prostoru.
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
Parametry: Pracovní prostor (ByValue)