Get-AzureRmOperationalInsightsSearchResults
Retourne les résultats de la recherche en fonction des paramètres spécifiés.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Get-AzureRmOperationalInsightsSearchResults
[-ResourceGroupName] <String>
[-WorkspaceName] <String>
[[-Top] <Int64>]
[[-PreHighlight] <String>]
[[-PostHighlight] <String>]
[[-Query] <String>]
[[-Start] <DateTime>]
[[-End] <DateTime>]
[[-Id] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Get-AzureRmOperationalInsightsSearchResults retourne les résultats de 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é.
Exemples
Exemple 1 : Obtenir les résultats de la recherche à l’aide d’une requête
PS C:\>Get-AzureRmOperationalInsightsSearchResults -ResourceGroupName "ContosoResourceGroup" -WorkspaceName "ContosoWorkspace" -Query "Type=Event" -Top 100
Cette commande obtient tous les résultats de recherche à l’aide d’une requête.
Exemple 2 : Obtenir les résultats de la recherche à l’aide d’un ID
PS C:\>Get-AzureRmOperationalInsightsSearchResults -ResourceGroupName "ContosoResourceGroup" -WorkspaceName "ContosoWorkspace" -Id "ContosoSearchId"
Cette commande obtient les résultats de la recherche à l’aide d’un ID.
Exemple 3 : Attendre la fin d’une recherche avant d’afficher les résultats
PS C:\>$error.clear()
$response = @{}
$StartTime = Get-Date
$resGroup = "ContosoResourceGroup"
$wrkspace = "ContosoWorkspace"
# Sample Query
$query = "Type=Event"
# Get Initial response
$response = Get-AzureRmOperationalInsightsSearchResults -WorkspaceName $wrkspace -ResourceGroupName $resGroup -Query $query -Top 15000
$elapsedTime = $(get-date) - $script:StartTime
Write-Host "Elapsed: " $elapsedTime "Status: " $response.Metadata.Status
# Split and extract request Id
$reqIdParts = $response.Id.Split("/")
$reqId = $reqIdParts[$reqIdParts.Count -1]
# Poll if pending
while($response.Metadata.Status -eq "Pending" -and $error.Count -eq 0) {
$response = Get-AzureRmOperationalInsightsSearchResults -WorkspaceName $wrkspace -ResourceGroupName $resGroup -Id $reqId
$elapsedTime = $(get-date) - $script:StartTime
Write-Host "Elapsed: " $elapsedTime "Status: " $response.Metadata.Status
}
Write-Host "Returned " $response.Value.Count " documents"
Write-Host $error
Ce script démarre une recherche et attend qu’elle se termine avant d’afficher les résultats.
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
Type: | IAzureContextContainer |
Alias: | 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 |
-End
Fin de l’intervalle de temps interrogé.
Type: | Nullable<T>[DateTime] |
Position: | 7 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Id
Si un ID est donné, les résultats de recherche de cet ID sont récupérés à l’aide des paramètres de requête d’origine.
Type: | String |
Position: | 8 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PostHighlight
Type: | String |
Position: | 4 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PreHighlight
Type: | String |
Position: | 3 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Query
Requête de recherche qui sera exécutée.
Type: | String |
Position: | 5 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Nom du groupe de ressources qui contient l’espace de travail.
Type: | String |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Start
Début de l’intervalle de temps interrogé.
Type: | Nullable<T>[DateTime] |
Position: | 6 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Top
Nombre maximal de résultats à renvoyer, limité à 5 000.
Type: | Int64 |
Position: | 2 |
Valeur par défaut: | 10 |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WorkspaceName
Spécifie un nom d’espace de travail.
Type: | String |
Alias: | Name |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
Entrées
Nullable<T>[[System.DateTime, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Sorties
PSSearchGetSearchResultsResponse