Invoke-AzOperationalInsightsQuery

Başvuru

Modül:: Az.OperationalInsights

Belirtilen parametrelere göre arama sonuçlarını döndürür.

Sözdizimi

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

Description

Invoke-AzOperationalInsightsQuery cmdlet'i, belirtilen parametrelere göre arama sonuçlarını döndürür. Döndürülen nesnenin Metadata özelliğinde aramanın durumuna erişebilirsiniz. Durum Beklemede ise arama tamamlanmaz ve sonuçlar arşivden çıkar. Döndürülen nesnenin Value özelliğinden aramanın sonuçlarını alabilirsiniz. Lütfen genel sorgu sınırlarının ayrıntılarını burada denetleyin: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Not: 'Yapılandırılan HttpClient.100 saniyelik zaman aşımı nedeniyle istek iptal edildi' hatasıyla karşılaşırsanız daha büyük bir değere ayarlamayı -Wait deneyin.

Örnekler

Örnek 1: Sorgu kullanarak arama sonuçlarını alma

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

çağrıldıktan sonra, $queryResults.Results sorgunuzdan elde edilen tüm satırları içerir.

Örnek 2: $results Dönüştür. Bir dizi için IEnumerable sonucu

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

Bazı sorgular çok büyük veri kümelerinin döndürülmesini sağlayabilir. Bu nedenle, cmdlet'in varsayılan davranışı bellek maliyetlerini azaltmak için IEnumerable döndürmektir. Bir sonuç dizisi olmasını tercih ederseniz, LINQ Enumerable.ToArray() uzantısı yöntemini kullanarak IEnumerable'ı bir diziye dönüştürebilirsiniz.

Örnek 3: Belirli bir zaman çerçevesi üzerinde sorgu kullanarak arama sonuçlarını alma

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

Bu sorgunun sonuçları son 24 saatle sınırlı olacaktır.

Örnek 4: Sorgu sonucuna işleme ve istatistikleri ekleme

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

$queryResults.Render

$queryResults.Statistics

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:	IAzureContextContainer
Diğer adlar:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IncludeRender

Belirtilirse, ölçüm sorguları için işleme bilgileri yanıta eklenir.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IncludeStatistics

Belirtilirse, sorgu istatistikleri yanıta eklenir.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Query

Yürütülecek sorgu.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Timespan

Sorgunun bağlandığı zaman aralığı.

Tür:	Nullable<T>[TimeSpan]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Wait

Sunucunun sorguyu işlemek için harcayacağı süreye bir üst sınır koyar. Bkz. https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Tür:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Workspace

ResourceName

Tür:	PSWorkspace
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-WorkspaceId

Çalışma alanı kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

PSWorkspace

Çıkışlar

PSQueryResponse

Aracılığıyla paylaş