Invoke-AzOperationalInsightsQuery

Ссылка

Модуль:: Az.OperationalInsights

Возвращает результаты поиска на основе указанных параметров.

Синтаксис

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>]

Описание

Командлет Invoke-AzOperationalInsightsQuery возвращает результаты поиска на основе указанных параметров. Вы можете получить доступ к состоянию поиска в свойстве метаданных возвращаемого объекта. Если состояние ожидается, поиск не завершен, и результаты будут находиться в архиве. Результаты поиска можно получить из свойства Value возвращаемого объекта. Дополнительные сведения об общих ограничениях запросов см. здесь: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Примечание. Попробуйте задать -Wait на большее значение, если возникла ошибка "Запрос был отменен из-за настроенного httpClient.Timeout в 100 секунд истекает".

Примеры

Пример 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)

Некоторые запросы могут привести к возврату очень больших наборов данных. Из-за этого поведение командлета по умолчанию — возврат 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

Запуск командлета в фоновом режиме

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:	IAzureContextContainer
Aliases:	AzContext, 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

Помещает верхнюю границу на время, которое сервер будет тратить на обработку запроса. См. https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Тип:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Workspace

Рабочая область

Тип:	PSWorkspace
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-WorkspaceId

Идентификатор рабочей области.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

PSWorkspace

Выходные данные

PSQueryResponse

Поделиться через