Invoke-AzureRmOperationalInsightsQuery
Restituisce i risultati della ricerca in base ai parametri specificati.
Avviso
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Sintassi
Invoke-AzureRmOperationalInsightsQuery
-WorkspaceId <String>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Invoke-AzureRmOperationalInsightsQuery
-Workspace <PSWorkspace>
-Query <String>
[-Timespan <TimeSpan>]
[-Wait <Int32>]
[-IncludeRender]
[-IncludeStatistics]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Descrizione
Il cmdlet Invoke-AzureRmOperationalInsightsQuery restituisce i risultati della ricerca in base ai parametri specificati. È possibile accedere allo stato della ricerca nella proprietà Metadata dell'oggetto restituito. Se lo stato è In sospeso, la ricerca non è stata completata e i risultati provengono dall'archivio. È possibile recuperare i risultati della ricerca dalla proprietà Value dell'oggetto restituito.
Esempio
Esempio 1: Ottenere i risultati della ricerca usando una query
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10"
PS C:\> $queryResults.Results
...
Una volta richiamato, $queryResults.Results conterrà tutte le righe risultanti dalla query.
Esempio 2: Convertire $results. Risultato IEnumberable in una matrice
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10"
PS C:\> $resultsArray = [System.Linq.Enumerable]::ToArray($results.Results)
...
Alcune query possono comportare la restituzione di set di dati di grandi dimensioni. Per questo motivo, il comportamento predefinito del cmdlet consiste nel restituire un IEnumerable per ridurre i costi di memoria. Se si preferisce avere una matrice di risultati, è possibile usare il metodo di estensione LINQ Enumerable.ToArray() per convertire IEnumerable in una matrice.
Esempio 3: Ottenere i risultati della ricerca usando una query in un intervallo di tempo specifico
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10" -Timespan (New-TimeSpan -Hours 24)
PS C:\> $queryResults.Results
...
I risultati di questa query saranno limitati alle ultime 24 ore.
Esempio 4: Includere rendering e statistiche nel risultato della query
PS C:\> $queryResults = Invoke-AzureRmOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query "union * | take 10" -IncludeRender -IncludeStatistics
PS C:\> $queryResults.Results
...
PS C:\> $queryResults.Render
...
PS C:\> $queryResults.Statistics
...
Parametri
-AsJob
Eseguire il cmdlet in background
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeRender
Se specificato, le informazioni di rendering per le query sulle metriche verranno incluse nella risposta.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeStatistics
Se specificato, le statistiche delle query verranno incluse nella risposta.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
Query da eseguire.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timespan
Intervallo di tempo in base al quale associare la query.
Tipo: | Nullable<T>[TimeSpan] |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
Imposta un limite superiore sulla quantità di tempo che il server spenderà per l'elaborazione della query.
Tipo: | Nullable<T>[Int32] |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Workspace
L'area di lavoro
Tipo: | PSWorkspace |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WorkspaceId
ID dell'area di lavoro.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Parametri: Area di lavoro (ByValue)