Get-AzureRmOperationalInsightsSearchResults

Modul:

AzureRM.OperationalInsights

Gibt Suchergebnisse basierend auf den angegebenen Parametern zurück.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet Get-AzureRmOperationalInsightsSearchResults gibt die Suchergebnisse basierend auf den angegebenen Parametern zurück. Sie können auf den Status der Suche in der Metadata-Eigenschaft des zurückgegebenen Objekts zugreifen. Wenn der Status ausstehend ist, wurde die Suche nicht abgeschlossen, und die Ergebnisse stammen aus dem Archiv. Sie können die Ergebnisse der Suche aus der Value-Eigenschaft des zurückgegebenen Objekts abrufen.

Beispiele

Beispiel 1: Abrufen von Suchergebnissen mithilfe einer Abfrage

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

Dieser Befehl ruft alle Suchergebnisse mithilfe einer Abfrage ab.

Beispiel 2: Abrufen von Suchergebnissen mithilfe einer ID

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

Dieser Befehl ruft Suchergebnisse mithilfe einer ID ab.

Beispiel 3: Warten, bis eine Suche abgeschlossen ist, bevor Ergebnisse angezeigt werden

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

Dieses Skript startet eine Suche und wartet, bis es abgeschlossen ist, bevor die Ergebnisse angezeigt werden.

Parameter

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:	IAzureContextContainer
Aliase:	AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-End

Ende des abgefragten Zeitraums.

Typ:	Nullable<T>[DateTime]
Position:	7
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Id

Wenn eine ID angegeben wird, werden die Suchergebnisse für diese ID mithilfe der ursprünglichen Abfrageparameter abgerufen.

Typ:	String
Position:	8
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PostHighlight

Typ:	String
Position:	4
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PreHighlight

Typ:	String
Position:	3
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Query

Die Suchabfrage, die ausgeführt wird.

Typ:	String
Position:	5
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Der Name der Ressourcengruppe, die den Arbeitsbereich enthält.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Start

Beginn des abgefragten Zeitraums.

Typ:	Nullable<T>[DateTime]
Position:	6
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Top

Die maximale Anzahl der zurückgegebenen Ergebnisse, beschränkt auf 5000.

Typ:	Int64
Position:	2
Standardwert:	10
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WorkspaceName

Gibt einen Arbeitsbereichsnamen an.

Typ:	String
Aliase:	Name
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

Eingaben

String

Int64

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

Ausgaben

PSSearchGetSearchResultsResponse

Ähnliche Themen

• Get-AzureRmOperationalInsightsSavedSearchResults