Condividi tramite

Get-AzureRmOperationalInsightsSearchResults

  • Riferimento
Modulo:
AzureRM.OperationalInsights

Restituisce i risultati della ricerca in base ai parametri specificati.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Get-AzureRmOperationalInsightsSearchResults
   [-ResourceGroupName] <String>
   [-WorkspaceName] <String>
   [[-Top] <Int64>]
   [[-PreHighlight] <String>]
   [[-PostHighlight] <String>]
   [[-Query] <String>]
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [[-Id] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzureRmOperationalInsightsSearchResults restituisce i risultati della ricerca in base ai parametri specificati. È possibile accedere allo stato della ricerca nella proprietà Metadata dell'oggetto restituito. Se lo stato è In sospeso, la ricerca non è stata completata e i risultati provengono dall'archivio. È possibile recuperare i risultati della ricerca dalla proprietà Value dell'oggetto restituito.

Esempio

Esempio 1: Ottenere i risultati della ricerca usando una query

PS C:\>Get-AzureRmOperationalInsightsSearchResults -ResourceGroupName "ContosoResourceGroup" -WorkspaceName "ContosoWorkspace" -Query "Type=Event" -Top 100

Questo comando ottiene tutti i risultati della ricerca usando una query.

Esempio 2: Ottenere i risultati della ricerca usando un ID

PS C:\>Get-AzureRmOperationalInsightsSearchResults -ResourceGroupName "ContosoResourceGroup" -WorkspaceName "ContosoWorkspace" -Id "ContosoSearchId"

Questo comando ottiene i risultati della ricerca usando un ID.

Esempio 3: Attendere il completamento di una ricerca prima di visualizzare i risultati

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

Questo script avvia una ricerca e attende il completamento prima di visualizzare i risultati.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-End

Fine dell'intervallo di tempo sottoposto a query.

Tipo:Nullable<T>[DateTime]
Position:7
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

Se viene specificato un ID, i risultati della ricerca per tale ID verranno recuperati usando i parametri di query originali.

Tipo:String
Position:8
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-PostHighlight

Tipo:String
Position:4
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-PreHighlight

Tipo:String
Position:3
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-Query

Query di ricerca che verrà eseguita.

Tipo:String
Position:5
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Nome del gruppo di risorse che contiene l'area di lavoro.

Tipo:String
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-Start

Inizio dell'intervallo di tempo sottoposto a query.

Tipo:Nullable<T>[DateTime]
Position:6
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-Top

Numero massimo di risultati da restituire, limitato a 5000.

Tipo:Int64
Position:2
valore predefinito:10
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-WorkspaceName

Specifica un nome dell'area di lavoro.

Tipo:String
Aliases:Name
Position:1
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Int64

Nullable<T>[[System.DateTime, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Output

PSSearchGetSearchResultsResponse