다음을 통해 공유

Get-AzureRmOperationalInsightsSearchResults

  • 참조
모듈:
AzureRM.OperationalInsights

지정된 매개 변수를 기반으로 검색 결과를 반환합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

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

Description

Get-AzureRmOperationalInsightsSearchResults cmdlet은 지정된 매개 변수에 따라 검색 결과를 반환합니다. 반환된 개체의 메타데이터 속성에서 검색의 상태 액세스할 수 있습니다. 상태 보류 중이면 검색이 완료되지 않고 결과가 보관 파일에서 생성됩니다. 반환된 개체의 Value 속성에서 검색 결과를 검색할 수 있습니다.

예제

예제 1: 쿼리를 사용하여 검색 결과 가져오기

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

이 명령은 쿼리를 사용하여 모든 검색 결과를 가져옵니다.

예제 2: ID를 사용하여 검색 결과 가져오기

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

이 명령은 ID를 사용하여 검색 결과를 가져옵니다.

예제 3: 결과를 표시하기 전에 검색이 완료되기를 기다립니다.

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

이 스크립트는 검색을 시작하고 결과를 표시하기 전에 완료될 때까지 기다립니다.

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-End

쿼리된 시간 범위의 끝입니다.

형식:Nullable<T>[DateTime]
Position:7
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Id

ID가 지정되면 원래 쿼리 매개 변수를 사용하여 해당 ID에 대한 검색 결과가 검색됩니다.

형식:String
Position:8
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PostHighlight

형식:String
Position:4
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PreHighlight

형식:String
Position:3
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Query

실행할 검색 쿼리입니다.

형식:String
Position:5
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

작업 영역을 포함하는 리소스 그룹의 이름입니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Start

쿼리된 시간 범위의 시작입니다.

형식:Nullable<T>[DateTime]
Position:6
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Top

반환할 최대 결과 수(5,000개로 제한)입니다.

형식:Int64
Position:2
Default value:10
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WorkspaceName

작업 영역 이름을 지정합니다.

형식:String
별칭:Name
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

Int64

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

출력

PSSearchGetSearchResultsResponse