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

PSWorkspace

Utdata

PSQueryResponse