Invoke-AzOperationalInsightsQuery

Module:

Az.OperationalInsights

Retourneert zoekresultaten op basis van de opgegeven parameters.

Syntaxis

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

Opmerking: probeer een hogere waarde in te stellen -Wait als u de fout 'De aanvraag is geannuleerd vanwege de geconfigureerde HttpClient.Timeout van 100 seconden die is verstreken' ervaart.

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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IncludeRender

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IncludeStatistics

Indien opgegeven, worden querystatistieken opgenomen in het antwoord.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Query

De query die moet worden uitgevoerd.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Timespan

De tijdspanne waarop de query moet worden gebonden.

Type:	Nullable<T>[TimeSpan]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Wait

Hiermee stelt u een bovengrens in voor de hoeveelheid tijd die de server besteedt aan het verwerken van de query. Zie: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Workspace

De werkruimte

Type:	PSWorkspace
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WorkspaceId

De werkruimte-id.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

PSWorkspace

Uitvoerwaarden

PSQueryResponse