Udostępnij przez

Invoke-AzOperationalInsightsQuery

Moduł:
Az.OperationalInsights Module

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

Składnia

ByWorkspaceId (Domyślne) 

Invoke-AzOperationalInsightsQuery
    -WorkspaceId <String>
    -Query <String>
    [-Timespan <TimeSpan>]
    [-Wait <Int32>]
    [-IncludeRender]
    [-IncludeStatistics]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByWorkspaceObject 

Invoke-AzOperationalInsightsQuery
    -Workspace <PSWorkspace>
    -Query <String>
    [-Timespan <TimeSpan>]
    [-Wait <Int32>]
    [-IncludeRender]
    [-IncludeStatistics]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Invoke-AzOperationalInsightsQuery 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.

Uwaga: spróbuj ustawić -Wait większą wartość, jeśli wystąpi błąd "Żądanie zostało anulowane z powodu skonfigurowanego limitu czasu HttpClient.Timeout 100 sekund".

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-IncludeRender

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-IncludeStatistics

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Query

Zapytanie do wykonania.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Timespan

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

Właściwości parametrów

Typ:

Nullable<T>[TimeSpan]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Wait

Umieszcza górną granicę czasu, przez jaki serwer spędzi przetwarzanie zapytania. Zobacz: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Workspace

Obszar roboczy

Właściwości parametrów

Typ:PSWorkspace
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByWorkspaceObject
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WorkspaceId

Identyfikator przestrzeni roboczej.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByWorkspaceId
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

PSWorkspace

Wyjść

PSQueryResponse