Invoke-AzOperationalInsightsQuery

Referensi

Modul:: Az.OperationalInsights

Mengembalikan hasil pencarian berdasarkan parameter yang ditentukan.

Sintaks

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

Deskripsi

Cmdlet Invoke-AzOperationalInsightsQuery mengembalikan hasil pencarian berdasarkan parameter yang ditentukan. Anda dapat mengakses status pencarian di properti Metadata dari objek yang dikembalikan. Jika status tertunda, maka pencarian belum selesai, dan hasilnya akan berasal dari arsip. Anda dapat mengambil hasil pencarian dari properti Nilai dari objek yang dikembalikan. Silakan periksa detail batas kueri umum di sini: https://docs.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Contoh

Contoh 1: Mendapatkan hasil pencarian menggunakan kueri

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

Setelah dipanggil, $queryResults.Results akan berisi semua baris yang dihasilkan dari kueri Anda.

Contoh 2: Konversi $results. Hasil IEnumerable ke array

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

Beberapa kueri dapat mengakibatkan himpunan data yang sangat besar dikembalikan. Karena itu, perilaku default cmdlet adalah mengembalikan IEnumerable untuk mengurangi biaya memori. Jika Anda lebih suka memiliki array hasil, Anda dapat menggunakan metode ekstensi LINQ Enumerable.ToArray() untuk mengonversi IEnumerable ke array.

Contoh 3: Mendapatkan hasil pencarian menggunakan kueri melalui jangka waktu tertentu

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

Hasil dari kueri ini akan dibatasi hingga 24 jam terakhir.

Contoh 4: Menyertakan statistik & render dalam hasil kueri

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

Lihat https://dev.loganalytics.io/documentation/Using-the-API/RequestOptions untuk detail tentang info render dan statistik.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

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

-IncludeRender

Jika ditentukan, informasi penyajian untuk kueri metrik akan disertakan dalam respons.

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

-IncludeStatistics

Jika ditentukan, statistik kueri akan disertakan dalam respons.

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

-Query

Kueri yang akan dijalankan.

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

-Timespan

Rentang waktu untuk mengikat kueri.

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

-Wait

Menempatkan batas atas pada jumlah waktu yang akan dihabiskan server untuk memproses kueri. Melihat: https://dev.loganalytics.io/documentation/Using-the-API/Timeouts

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

-Workspace

Ruang kerja

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

-WorkspaceId

ID ruang kerja.

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

Input

PSWorkspace

Output

PSQueryResponse