Invoke-AzOperationalInsightsQuery

Referentie

Module:: Az.OperationalInsights

Retourneert zoekresultaten op basis van de opgegeven parameters.

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

De cmdlet Invoke-AzOperationalInsightsQuery retourneert de zoekresultaten op basis van de opgegeven parameters. U hebt toegang tot de status van de zoekopdracht in de eigenschap Metagegevens van het geretourneerde object. Als de status In behandeling is, is de zoekopdracht niet voltooid en zijn de resultaten afkomstig uit het archief. U kunt de resultaten van de zoekopdracht ophalen uit de eigenschap Waarde van het geretourneerde object. Bekijk hier de details van algemene querylimieten: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language

Voorbeelden

Voorbeeld 1: Zoekresultaten ophalen met behulp van een query

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results

Zodra de query is aangeroepen, bevat $queryResults.Results alle resulterende rijen uit uw query.

Voorbeeld 2: $results converteren. Resultaat-IEnumerable voor een matrix

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)

Sommige query's kunnen ertoe leiden dat zeer grote gegevenssets worden geretourneerd. Daarom is het standaardgedrag van de cmdlet het retourneren van een IEnumerable om de geheugenkosten te verlagen. Als u liever een matrix met resultaten hebt, kunt u de extensiemethode LINQ Enumerable.ToArray() gebruiken om de IEnumerable te converteren naar een matrix.

Voorbeeld 3: Zoekresultaten ophalen met behulp van een query gedurende een bepaalde periode

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results

De resultaten van deze query zijn beperkt tot de afgelopen 24 uur.

Voorbeeld 4: Render &statistics opnemen in het queryresultaat

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results

$queryResults.Render

$queryResults.Statistics

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeRender

Indien opgegeven, worden renderinggegevens voor metrische query's opgenomen in het antwoord.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeStatistics

Indien opgegeven, worden querystatistieken opgenomen in het antwoord.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

De query die moet worden uitgevoerd.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Timespan

De tijdspanne waarop de query moet worden gebonden.

Type:	Nullable<T>[TimeSpan]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Wait

Hiermee stelt u een bovengrens in voor de hoeveelheid tijd die de server besteedt aan het verwerken van de query.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

De werkruimte

Type:	PSWorkspace
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WorkspaceId

De werkruimte-id.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

PSWorkspace

Uitvoerwaarden

PSQueryResponse