Invoke-AzOperationalInsightsQuery
Returnerar sökresultat baserat på de angivna parametrarna.
Syntax
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
Cmdleten Invoke-AzOperationalInsightsQuery returnerar sökresultaten baserat på de angivna parametrarna. Du kan komma åt statusen för sökningen i metadataegenskapen för det returnerade objektet. Om statusen är Väntande har sökningen inte slutförts och resultatet kommer från arkivet. Du kan hämta resultatet av sökningen från egenskapen Value för det returnerade objektet. Läs mer om allmänna frågegränser här: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.
Exempel
Exempel 1: Hämta sökresultat med hjälp av en fråga
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results
När den har anropats innehåller $queryResults.Results alla resulterande rader från din fråga.
Exempel 2: Konvertera $results. Resultat-IEnumerable till en matris
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)
Vissa frågor kan leda till att mycket stora datamängder returneras. Därför är standardbeteendet för cmdleten att returnera en IEnumerable för att minska minneskostnaderna. Om du föredrar att ha en matris med resultat kan du använda filnamnstilläggsmetoden LINQ Enumerable.ToArray() för att konvertera IEnumerable till en matris.
Exempel 3: Hämta sökresultat med hjälp av en fråga över en viss tidsram
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results
Resultatet från den här frågan begränsas till de senaste 24 timmarna.
Exempel 4: Inkludera återgivning och statistik i frågeresultat
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results
$queryResults.Render
$queryResults.Statistics
Parametrar
-AsJob
Kör cmdlet i bakgrunden
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeRender
Om det anges inkluderas återgivningsinformation för måttfrågor i svaret.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeStatistics
Om det anges inkluderas frågestatistik i svaret.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
Frågan som ska köras.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timespan
Tidsintervallet för att binda frågan efter.
Type: | Nullable<T>[TimeSpan] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
Anger en övre gräns för hur lång tid servern kommer att ägna åt att bearbeta frågan.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Workspace
Arbetsytan
Type: | PSWorkspace |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WorkspaceId
Arbetsytans ID.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Utdata
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för