Invoke-AzOperationalInsightsQuery
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-AzOperational Analizler Query 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 |