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 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://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Catatan: coba atur -Wait ke nilai yang lebih besar jika Anda mengalami kesalahan 'Permintaan dibatalkan karena HttpClient.Timeout yang dikonfigurasi 100 detik berlalu'.

Contoh

Contoh 1: Mendapatkan hasil pencarian menggunakan kueri

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

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

Contoh 2: Konversi $results. Hasil IEnumerable ke array

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$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 selama jangka waktu tertentu

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

Hasil dari kueri ini akan dibatasi hingga 24 jam terakhir.

Contoh 4: Menyertakan render & statistik dalam hasil kueri

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

$queryResults.Render

$queryResults.Statistics

Parameter

-AsJob

Jalankan cmdlet di latar belakang

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

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

Jenis:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeRender

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeStatistics

Jika ditentukan, statistik kueri akan disertakan dalam respons.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Query

Kueri yang akan dijalankan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Timespan

Rentang waktu untuk mengikat kueri.

Jenis:	Nullable<T>[TimeSpan]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Wait

Menempatkan batas atas pada jumlah waktu yang akan dihabiskan server untuk memproses kueri. Lihat: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Jenis:	Nullable<T>[Int32]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Workspace

Ruang kerja

Jenis:	PSWorkspace
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-WorkspaceId

ID ruang kerja.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

Input

PSWorkspace

Output

PSQueryResponse

Bagikan melalui