Invoke-AzOperationalInsightsQuery

Başvuru

Modül:: Az.OperationalInsights

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

Syntax

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
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Tür:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeRender

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

Tür:	SwitchParameter
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeStatistics

Belirtilirse, sorgu istatistikleri yanıta eklenir.

Tür:	SwitchParameter
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

Yürütülecek sorgu.

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Timespan

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

Tür:	Nullable<T>[TimeSpan]
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	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
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

ResourceName

Tür:	PSWorkspace
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WorkspaceId

Çalışma alanı kimliği.

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

PSWorkspace

Çıkışlar

PSQueryResponse

Aracılığıyla paylaş