Partager via

Invoke-AzOperationalInsightsQuery

  • Référence
Module:
Az.OperationalInsights

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

Syntaxe

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-AzOperationalInsightsQuery 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é. Consultez les détails des limites de requête générales ici : https://zcusa.951200.xyz/azure/azure-monitor/service-limits#log-queries-and-language.

Remarque : essayez de définir -Wait une valeur supérieure si vous rencontrez l’erreur « La requête a été annulée en raison du délai d’expiration httpClient.Timeout configuré de 100 secondes ».

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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

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

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IncludeStatistics

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Query

Requête à exécuter.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Timespan

Intervalle de temps pour lier la requête.

Type:Nullable<T>[TimeSpan]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Wait

Place une limite supérieure sur la durée pendant laquelle le serveur passe le traitement de la requête. Consultez : https://zcusa.951200.xyz/azure/azure-monitor/logs/api/timeouts

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Workspace

L’espace de travail

Type:PSWorkspace
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WorkspaceId

L’ID de l’espace de travail.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSWorkspace

Sorties

PSQueryResponse