Invoke-AzOperationalInsightsQuery

Odwołanie

Moduł:: Az.OperationalInsights

Zwraca wyniki wyszukiwania na podstawie określonych parametrów.

Składnia

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

Opis

Polecenie cmdlet Invoke-AzOperational Szczegółowe informacje Query zwraca wyniki wyszukiwania na podstawie określonych parametrów. Możesz uzyskać dostęp do stanu wyszukiwania we właściwości Metadata zwróconego obiektu. Jeśli stan to Oczekiwanie, wyszukiwanie nie zostało ukończone, a wyniki będą pochodzić z archiwum. Wyniki wyszukiwania można pobrać z właściwości Value zwróconego obiektu. Sprawdź szczegóły ogólnych limitów zapytań tutaj: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Przykłady

Przykład 1. Pobieranie wyników wyszukiwania przy użyciu zapytania

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results

Po wywołaniu $queryResults.Wyniki będą zawierać wszystkie wiersze wynikowe z zapytania.

Przykład 2. Konwertowanie $results. Wynik IEnumerable do tablicy

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)

Niektóre zapytania mogą powodować zwracanie bardzo dużych zestawów danych. W związku z tym domyślne zachowanie polecenia cmdlet polega na zwracaniu liczby IEnumerable w celu zmniejszenia kosztów pamięci. Jeśli wolisz mieć tablicę wyników, możesz użyć metody rozszerzenia LINQ Enumerable.ToArray(), aby przekonwertować element IEnumerable na tablicę.

Przykład 3. Pobieranie wyników wyszukiwania przy użyciu zapytania w określonym przedziale czasu

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results

Wyniki z tego zapytania będą ograniczone do ostatnich 24 godzin.

Przykład 4. Uwzględnij renderowanie i statystyki w wyniku zapytania

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results

$queryResults.Render

$queryResults.Statistics

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeRender

Jeśli zostanie określony, informacje o renderowaniu zapytań dotyczących metryk zostaną uwzględnione w odpowiedzi.

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

-IncludeStatistics

Jeśli zostanie określony, statystyki zapytań zostaną uwzględnione w odpowiedzi.

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

-Query

Zapytanie do wykonania.

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

-Timespan

Przedział czasu, przez który ma być powiązane zapytanie.

Type:	Nullable<T>[TimeSpan]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Wait

Umieszcza górną granicę czasu, przez jaki serwer spędzi przetwarzanie zapytania.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

Obszar roboczy

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

-WorkspaceId

Identyfikator obszaru roboczego.

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

Dane wejściowe

PSWorkspace

Dane wyjściowe

PSQueryResponse