Invoke-AzOperationalInsightsQuery

Référence

Module:: Az.OperationalInsights

Retourne les résultats de la recherche en fonction des paramètres spécifiés.

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

L’applet de commande Invoke-AzOperational Recommandations Query retourne les résultats de la recherche en fonction des paramètres spécifiés. Vous pouvez accéder à l’état de la recherche dans la propriété Métadonnées de l’objet retourné. Si l’état est En attente, la recherche n’est pas terminée et les résultats proviennent de l’archive. Vous pouvez récupérer les résultats de la recherche à partir de la propriété Value de l’objet retourné. Veuillez case activée détail des limites de requête générales ici : https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Exemples

Exemple 1 : Obtenir les résultats de la recherche à l’aide d’une requête

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

Une fois appelée, $queryResults.Results contiendra toutes les lignes résultantes de votre requête.

Exemple 2 : Convertir $results. Résultat IEnumerable dans un tableau

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

Certaines requêtes peuvent entraîner un retour de jeux de données très volumineux. En raison de cela, le comportement par défaut de l’applet de commande consiste à retourner un IEnumerable pour réduire les coûts de mémoire. Si vous préférez avoir un tableau de résultats, vous pouvez utiliser la méthode d’extension LINQ Enumerable.ToArray() pour convertir IEnumerable en tableau.

Exemple 3 : Obtenir des résultats de recherche à l’aide d’une requête sur une période spécifique

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

Les résultats de cette requête seront limités aux 24 dernières heures.

Exemple 4 : Inclure le rendu et les statistiques dans le résultat de la requête

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

$queryResults.Render

$queryResults.Statistics

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

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

-IncludeRender

Si elle est spécifiée, les informations de rendu des requêtes de métriques sont incluses dans la réponse.

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

-IncludeStatistics

Si elle est spécifiée, les statistiques de requête sont incluses dans la réponse.

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

-Query

Requête à exécuter.

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

-Timespan

Intervalle de temps pour lier la requête.

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

-Wait

Place une limite supérieure sur la durée pendant laquelle le serveur passe le traitement de la requête.

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

-Workspace

L’espace de travail

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

-WorkspaceId

L’ID de l’espace de travail.

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

Entrées

PSWorkspace

Sorties

PSQueryResponse