Invoke-AzIotHubQuery

Odwołanie

Moduł:: Az.IotHub

Wykonywanie zapytań w usłudze IoT Hub przy użyciu zaawansowanego języka przypominającego sql.

Składnia

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>]

Opis

Wykonywanie zapytań w usłudze IoT Hub przy użyciu zaawansowanego języka przypominającego SQL w celu pobrania informacji dotyczących bliźniaczych reprezentacji urządzeń i modułów, zadań i routingu komunikatów. Aby uzyskać więcej informacji, zobacz https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language.

Przykłady

Przykład 1

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

Wykonywanie zapytań dotyczących wszystkich danych bliźniaczej reprezentacji urządzenia w usłudze Azure IoT Hub.

Przykład 2

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

Wykonywanie zapytań dotyczących najważniejszych danych bliźniaczej reprezentacji modułu 2 na urządzeniu docelowym.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Obiekt IotHub

Typ:	PSIotHub
Position:	0
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IotHubName

Nazwa centrum Iot Hub

Typ:	String
Position:	1
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

Zapytanie użytkownika do wykonania.

Typ:	String
Position:	1
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nazwa grupy zasobów

Typ:	String
Position:	0
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Identyfikator zasobu usługi IotHub

Typ:	String
Position:	0
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Top

Maksymalna liczba elementów do zwrócenia. Domyślnie zapytanie nie ma limitu.

Typ:	Int32
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

PSIotHub

String

Dane wyjściowe