Invoke-AzIotHubQuery

參考

模組:: Az.IotHub

使用功能強大的 SQL 型語言來查詢 IoT 中樞。

語法

Invoke-AzIotHubQuery
      [-ResourceGroupName] <String>
      [-IotHubName] <String>
      [-Query] <String>
      [-Top <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzIotHubQuery
      [-InputObject] <PSIotHub>
      [-Query] <String>
      [-Top <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzIotHubQuery
      [-ResourceId] <String>
      [-Query] <String>
      [-Top <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

使用強大的類似 SQL 語言來查詢 IoT 中樞，以擷取裝置和模組對應項、作業和訊息路由的相關信息。如需相關資訊，請參閱 https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language 。

範例

範例 1

Invoke-AzIotHubQuery -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Query "select * from devices"

查詢 Azure IoT 中樞中的所有裝置對應項數據。

範例 2

Invoke-AzIotHubQuery -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Query "select * from devices.modules where devices.deviceId = 'myDevice1'" -Top 2

在目標裝置上查詢前 2 個模組對應項數據。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

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

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

IotHub 物件

類型:	PSIotHub
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-IotHubName

IoT 中樞的名稱

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Query

要執行的用戶查詢。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceId

IotHub 資源標識碼

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Top

要傳回的項目數目上限。根據預設，查詢沒有上限。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

PSIotHub

String

輸出