Dela via


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.

Obs! Försök att ange -Wait ett större värde om du får felet "Begäran avbröts på grund av den konfigurerade HttpClient.Timeout på 100 sekunder som förflutit".

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeRender

Om det anges inkluderas återgivningsinformation för måttfrågor i svaret.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeStatistics

Om det anges inkluderas frågestatistik i svaret.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Query

Frågan som ska köras.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Timespan

Tidsintervallet för att binda frågan efter.

Typ:Nullable<T>[TimeSpan]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Wait

Anger en övre gräns för hur lång tid servern kommer att ägna åt att bearbeta frågan. Se: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Workspace

Arbetsytan

Typ:PSWorkspace
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WorkspaceId

Arbetsytans ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSWorkspace

Utdata

PSQueryResponse