Invoke-AzOperationalInsightsQuery
지정된 매개 변수를 기반으로 검색 결과를 반환합니다.
Syntax
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
Invoke-AzOperationalInsightsQuery cmdlet은 지정된 매개 변수에 따라 검색 결과를 반환합니다. 반환된 개체의 메타데이터 속성에서 검색의 상태 액세스할 수 있습니다. 상태 보류 중이면 검색이 완료되지 않고 결과가 보관 파일에서 생성됩니다. 반환된 개체의 Value 속성에서 검색 결과를 검색할 수 있습니다. 일반적인 쿼리 제한에 대한 자세한 내용은 다음https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language을 검사.
예제
예제 1: 쿼리를 사용하여 검색 결과 가져오기
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results
호출되면 $queryResults.Results에는 쿼리의 결과 행이 모두 포함됩니다.
예제 2: $results 변환합니다. 배열에 대한 결과 IEnumerable
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)
일부 쿼리는 매우 큰 데이터 집합이 반환될 수 있습니다. 이 때문에 cmdlet의 기본 동작은 메모리 비용을 줄이기 위해 IEnumerable을 반환하는 것입니다. 결과 배열을 사용하려는 경우 LINQ Enumerable.ToArray() 확장 메서드를 사용하여 IEnumerable을 배열로 변환할 수 있습니다.
예제 3: 특정 기간 동안 쿼리를 사용하여 검색 결과 가져오기
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results
이 쿼리의 결과는 지난 24시간으로 제한됩니다.
예제 4: 쿼리 결과에 렌더링 및 통계 포함
$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results
$queryResults.Render
$queryResults.Statistics
매개 변수
-AsJob
백그라운드에서 cmdlet 실행
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeRender
지정된 경우 메트릭 쿼리에 대한 렌더링 정보가 응답에 포함됩니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeStatistics
지정된 경우 쿼리 통계가 응답에 포함됩니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
실행할 쿼리입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timespan
쿼리를 바인딩할 시간 범위입니다.
Type: | Nullable<T>[TimeSpan] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
서버에서 쿼리를 처리하는 데 소요되는 시간에 상한을 지정합니다.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Workspace
클러스터 자동 크기 조정(규모 확대 및 축소) 중
Type: | PSWorkspace |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WorkspaceId
작업 영역 ID
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |