Invoke-AzureRmOperationalInsightsQuery
지정된 매개 변수를 기반으로 검색 결과를 반환합니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
Invoke-AzureRmOperationalInsightsQuery
-WorkspaceId <String>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Invoke-AzureRmOperationalInsightsQuery
-Workspace <PSWorkspace>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Invoke-AzureRmOperationalInsightsQuery cmdlet은 지정된 매개 변수에 따라 검색 결과를 반환합니다. 반환된 개체의 메타데이터 속성에서 검색 상태에 액세스할 수 있습니다. 상태가 보류 중이면 검색이 완료되지 않고 결과가 보관 파일에서 생성됩니다. 반환된 개체의 Value 속성에서 검색 결과를 검색할 수 있습니다.
예제
예제 1: 쿼리를 사용하여 검색 결과 가져오기
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10"
PS C:\> $queryResults.Results
...호출되면 $queryResults.Results에는 쿼리의 결과 행이 모두 포함됩니다.
예제 2: $results 변환합니다. 배열에 대한 결과 IEnumberable
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10"
PS C:\> $resultsArray = [System.Linq.Enumerable]::ToArray($results.Results)
...일부 쿼리는 매우 큰 데이터 집합이 반환될 수 있습니다. 이 때문에 cmdlet의 기본 동작은 메모리 비용을 줄이기 위해 IEnumerable을 반환하는 것입니다. 결과 배열을 사용하려는 경우 LINQ Enumerable.ToArray() 확장 메서드를 사용하여 IEnumerable을 배열로 변환할 수 있습니다.
예제 3: 특정 기간 동안 쿼리를 사용하여 검색 결과 가져오기
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10" -Timespan (New-TimeSpan -Hours 24)
PS C:\> $queryResults.Results
...이 쿼리의 결과는 지난 24시간으로 제한됩니다.
예제 4: 쿼리 결과에 렌더링 및 통계 포함
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10" -IncludeRender -IncludeStatistics
PS C:\> $queryResults.Results
...
PS C:\> $queryResults.Render
...
PS C:\> $queryResults.Statistics
...매개 변수
-AsJob
백그라운드에서 cmdlet 실행
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IncludeRender
지정된 경우 메트릭 쿼리에 대한 렌더링 정보가 응답에 포함됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IncludeStatistics
지정된 경우 쿼리 통계가 응답에 포함됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Query
실행할 쿼리입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Timespan
쿼리를 바인딩할 시간 범위입니다.
| 형식: | Nullable<T>[TimeSpan] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Wait
서버에서 쿼리를 처리하는 데 소요되는 시간에 상한을 지정합니다.
| 형식: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Workspace
클러스터 자동 크기 조정(규모 확대 및 축소) 중
| 형식: | PSWorkspace |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-WorkspaceId
작업 영역 ID
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
매개 변수: 작업 영역(ByValue)