Invoke-AzOperationalInsightsQuery

  • Referencia
Modul:
Az.OperationalInsights

A megadott paraméterek alapján adja vissza a keresési eredményeket.

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

Az Invoke-AzOperational Elemzések Query parancsmag a megadott paraméterek alapján adja vissza a keresési eredményeket. A keresés állapotát a visszaadott objektum Metaadat tulajdonságában érheti el. Ha az állapot függőben van, akkor a keresés nem fejeződött be, és az eredmények az archívumból származnak. A keresés eredményeit lekérheti a visszaadott objektum Érték tulajdonságából. Itt tekintheti meg az általános lekérdezési korlátok részleteit: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Példák

1. példa: Keresési eredmények lekérése lekérdezéssel

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

A meghívást követően a $queryResults.Results a lekérdezés összes eredménysorát tartalmazza.

2. példa: $results konvertálása. Tömbhöz nem használható eredmény

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

Egyes lekérdezések nagyon nagy adatkészletek visszaadása eredményezhetik. Emiatt a parancsmag alapértelmezett viselkedése az, hogy egy IEnumerable értéket ad vissza a memóriaköltségek csökkentése érdekében. Ha egy eredménytömböt szeretne használni, a LINQ Enumerable.ToArray() bővítménymetódussal tömbzé alakíthatja az IEnumerable függvényt.

3. példa: Keresési eredmények lekérése lekérdezéssel egy adott időkereten keresztül

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

A lekérdezés eredményei az elmúlt 24 órára korlátozódnak.

4. példa: Render & statisztikai adatok belefoglalása a lekérdezés eredményében

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

$queryResults.Render

$queryResults.Statistics

Paraméterek

-AsJob

Parancsmag futtatása a háttérben

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-IncludeRender

Ha meg van adva, a metrika-lekérdezések renderelési információi szerepelni fognak a válaszban.

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

-IncludeStatistics

Ha meg van adva, a lekérdezési statisztikák szerepelni fognak a válaszban.

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

-Query

A végrehajtandó lekérdezés.

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

-Timespan

A lekérdezéshez kötött időkorlát.

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

-Wait

A kiszolgáló által a lekérdezés feldolgozására fordított idő felső határát adja meg.

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

-Workspace

A(z)

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

-WorkspaceId

A munkaterület azonosítója.

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

Bevitelek

PSWorkspace

Kimenetek

PSQueryResponse