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-AzOperational Аналитика Query возвращает результаты поиска на основе указанных параметров. Вы можете получить доступ к состоянию поиска в свойстве метаданных возвращаемого объекта. Если состояние ожидается, поиск не завершен, и результаты будут находиться в архиве. Результаты поиска можно получить из свойства 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)

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

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

PSWorkspace

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

PSQueryResponse