Invoke-AzOperationalInsightsQuery

根據指定的參數傳回搜尋結果。

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-AzOperationalInsightsQuery Cmdlet 會根據指定的參數傳回搜尋結果。 您可以在傳回物件的 Metadata 屬性中存取搜尋的狀態。 如果狀態為 [擱置],則搜尋尚未完成,且結果會來自封存。 您可以從傳回物件的 Value 屬性擷取搜尋的結果。 請在這裡查看一般查詢限制的詳細數據: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language

範例

範例 1:使用查詢取得搜尋結果

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

叫用之後,$queryResults.Results 會包含來自查詢的所有結果數據列。

範例 2:轉換$results。結果 IEnumerable 至數位

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

某些查詢可能會導致傳回非常大的數據集。 因此,Cmdlet 的預設行為是傳回 IEnumerable 以降低記憶體成本。 如果您想要有結果陣列,您可以使用LINQ Enumerable.ToArray() 擴充方法,將 IEnumerable 轉換成數位。

範例 3:在特定時間範圍內使用查詢取得搜尋結果

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

此查詢的結果將限制為過去 24 小時。

範例 4:在查詢結果中包含轉譯和統計數據

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

$queryResults.Render

$queryResults.Statistics

參數

-AsJob

在背景執行 Cmdlet

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-IncludeRender

如果指定,計量查詢的轉譯資訊將會包含在回應中。

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

-IncludeStatistics

如果指定,查詢統計數據將會包含在回應中。

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

-Query

要執行的查詢。

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

-Timespan

系結查詢所依據的時間範圍。

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

-Wait

將上限放在伺服器處理查詢的時間量上。

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

-Workspace

工作區

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

-WorkspaceId

工作區標識碼。

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

輸入

PSWorkspace

輸出

PSQueryResponse