Schnellstart: Senden von Telemetriedaten von einem Gerät an eine IoT Hub-Instanz und Lesen der Telemetriedaten aus der IoT Hub-Instanz mit einer Back-End-Anwendung (C)Quickstart: Send telemetry from a device to an IoT hub and read it with a back-end application (C)

IoT Hub ist ein Azure-Dienst, mit dem Sie umfangreiche Telemetriedaten von Ihren Geräten in der Cloud erfassen können, um sie zu speichern oder zu verarbeiten.IoT Hub is an Azure service that enables you to ingest high volumes of telemetry from your IoT devices into the cloud for storage or processing. In dieser Schnellstartanleitung senden Sie Telemetriedaten von einer Anwendung zur Simulation eines Geräts über IoT Hub zur Verarbeitung an eine Back-End-Anwendung.In this quickstart, you send telemetry from a simulated device application, through IoT Hub, to a back-end application for processing.

Die Schnellstartanleitung verwendet eine C-Beispielanwendung aus dem Azure IoT-Geräte-SDK für C, um Telemetriedaten an einen IoT-Hub zu senden.The quickstart uses a C sample application from the Azure IoT device SDK for C to send telemetry to an IoT hub. Die Azure IoT-Geräte-SDKs wurden in ANSI C (C99) geschrieben und sind auf Portabilität und breit gefächerte Plattformkompatibilität ausgelegt.The Azure IoT device SDKs are written in ANSI C (C99) for portability and broad platform compatibility. Bevor Sie den Beispielcode ausführen, erstellen Sie einen IoT-Hub und registrieren das simulierte Gerät bei diesem Hub.Before running the sample code, you will create an IoT hub and register the simulated device with that hub.

Dieser Artikel wurde für Windows geschrieben, Sie können die Schnellstartanleitung aber auch unter Linux ausführen.This article is written for Windows, but you can complete this quickstart on Linux as well.

Verwenden von Azure Cloud ShellUse Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Starten von Azure Cloud Shell:To start Azure Cloud Shell:

OptionOption Beispiel/LinkExample/Link
Klicken Sie in der rechten oberen Ecke eines Codeblocks auf Ausprobieren.Select Try It in the upper-right corner of a code block. Durch die Auswahl von Ausprobieren wird der Code nicht automatisch in Cloud Shell kopiert.Selecting Try It doesn't automatically copy the code to Cloud Shell. Beispiel für „Testen Sie es.“ für Azure Cloud Shell
Rufen Sie https://shell.azure.com auf, oder wählen Sie die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Starten von Cloud Shell in einem neuen FensterLaunch Cloud Shell in a new window
Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Cloud Shell-Schaltfläche im Azure-Portal

Ausführen des Codes in diesem Artikel in Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Starten Sie Cloud Shell.Start Cloud Shell.

  2. Wählen Sie die Schaltfläche Kopieren für einen Codeblock, um den Code zu kopieren.Select the Copy button on a code block to copy the code.

  3. Fügen Sie den Code mit STRG+UMSCHALT+V unter Windows und Linux oder Cmd+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Drücken Sie die EINGABETASTE, um den Code auszuführen.Select Enter to run the code.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.If you don't have an Azure subscription, create a free account before you begin.

VoraussetzungenPrerequisites

  • Installieren Sie Visual Studio 2019 mit der aktivierten Workload Desktopentwicklung mit C++.Install Visual Studio 2019 with the 'Desktop development with C++' workload enabled.

  • Installieren Sie die aktuelle Version von Git.Install the latest version of Git.

  • Stellen Sie sicher, dass Port 8883 in Ihrer Firewall geöffnet ist.Make sure that port 8883 is open in your firewall. Für das Beispielgerät in dieser Schnellstartanleitung wird das MQTT-Protokoll verwendet, das über den Port 8883 kommuniziert.The device sample in this quickstart uses MQTT protocol, which communicates over port 8883. In einigen Netzwerkumgebungen von Unternehmen oder Bildungseinrichtungen ist dieser Port unter Umständen blockiert.This port may be blocked in some corporate and educational network environments. Weitere Informationen und Problemumgehungen finden Sie unter Herstellen einer Verbindung mit IoT Hub (MQTT).For more information and ways to work around this issue, see Connecting to IoT Hub (MQTT).

  • Führen Sie den folgenden Befehl aus, um Ihrer Cloud Shell-Instanz die Microsoft Azure IoT-Erweiterung für die Azure-Befehlszeilenschnittstelle hinzuzufügen.Run the following command to add the Microsoft Azure IoT Extension for Azure CLI to your Cloud Shell instance. Die IoT-Erweiterung fügt der Azure-Befehlszeilenschnittstelle spezifische Befehle für IoT Hub, IoT Edge und IoT Device Provisioning Service (DPS) hinzu.The IoT Extension adds IoT Hub, IoT Edge, and IoT Device Provisioning Service (DPS) specific commands to Azure CLI.

    az extension add --name azure-iot
    

Hinweis

In diesem Artikel wird die neueste Version der Azure IoT-Erweiterung namens azure-iot verwendet.This article uses the newest version of the Azure IoT extension, called azure-iot. Die Legacy-Version heißt azure-cli-iot-ext. Es sollte jedoch jeweils nur eine Version installiert sein.The legacy version is called azure-cli-iot-ext.You should only have one version installed at a time. Sie können den Befehl az extension list verwenden, um die derzeit installierten Erweiterungen zu überprüfen.You can use the command az extension list to validate the currently installed extensions.

Verwenden Sie az extension remove --name azure-cli-iot-ext, um die Legacy-Version der Erweiterung zu entfernen.Use az extension remove --name azure-cli-iot-ext to remove the legacy version of the extension.

Verwenden Sie az extension add --name azure-iot, um die neue Version der Erweiterung hinzuzufügen.Use az extension add --name azure-iot to add the new version of the extension.

Verwenden Sie az extension list, um die installierten Erweiterungen anzuzeigen.To see what extensions you have installed, use az extension list.

Vorbereiten der EntwicklungsumgebungPrepare the development environment

Für diesen Schnellstart verwenden Sie das Azure IoT-Geräte-SDK für C.For this quickstart, you'll be using the Azure IoT device SDK for C.

Sie können das SDK verwenden, indem Sie die Pakete und Bibliotheken für die folgenden Umgebungen installieren:For the following environments, you can use the SDK by installing these packages and libraries:

  • Linux: apt-get-Pakete sind für Ubuntu 16.04 und 18.04 mit folgenden CPU-Architekturen verfügbar: amd64, arm64, armhf und i386.Linux: apt-get packages are available for Ubuntu 16.04 and 18.04 using the following CPU architectures: amd64, arm64, armhf, and i386. Weitere Informationen finden Sie unter Using apt-get to create a C device client project on Ubuntu (Verwenden von apt-get zum Erstellen eines C-Geräteclientprojekts unter Ubuntu).For more information, see Using apt-get to create a C device client project on Ubuntu.

  • mbed: Für Entwickler, die Geräteanwendungen auf der mbed-Plattform erstellen, haben wir eine Bibliothek und Beispiele veröffentlicht, mit denen Sie in wenigen Minuten mit Azure IoT Hub beginnen können.mbed: For developers creating device applications on the mbed platform, we've published a library and samples that will get you started in minutes witH Azure IoT Hub. Weitere Informationen finden Sie unter Use the mbed library (Verwenden der mbed-Bibliothek).For more information, see Use the mbed library.

  • Arduino: Wenn Sie mit Arduino entwickeln, können Sie die Azure-IoT-Bibliothek verwenden, die im Bibliotheks-Manager der Arduino-IDE zur Verfügung steht.Arduino: If you're developing on Arduino, you can leverage the Azure IoT library available in the Arduino IDE library manager. Weitere Informationen finden Sie unter The Azure IoT Hub library for Arduino (Die Azure-IoT-Hub-Bibliothek für Arduino).For more information, see The Azure IoT Hub library for Arduino.

  • iOS: Das IoT Hub-Geräte-SDK ist als CocoaPods für die Entwicklung von Mac- und iOS-Geräten verfügbar.iOS: The IoT Hub Device SDK is available as CocoaPods for Mac and iOS device development. Weitere Informationen finden Sie unter iOS Samples for Microsoft Azure IoT (iOS-Beispiele für Microsoft Azure IoT).For more information, see iOS Samples for Microsoft Azure IoT.

In diesem Schnellstart bereiten Sie eine Entwicklungsumgebung vor, die zum Klonen und Erstellen des Azure-IoT-C-SDK aus GitHub verwendet wird.However, in this quickstart, you'll prepare a development environment used to clone and build the Azure IoT C SDK from GitHub. Das SDK auf GitHub enthält den in dieser Schnellstartanleitung verwendeten Beispielcode.The SDK on GitHub includes the sample code used in this quickstart.

  1. Laden Sie das CMake-Buildsystem herunter.Download the CMake build system.

    Wichtig: Die Voraussetzungen für Visual Studio (Visual Studio und die Workload „Desktopentwicklung mit C++“) müssen vor Beginn der Installation von CMake auf dem Computer installiert sein.It is important that the Visual Studio prerequisites (Visual Studio and the 'Desktop development with C++' workload) are installed on your machine, before starting the CMake installation. Sobald die Voraussetzungen erfüllt sind und der Download überprüft wurde, installieren Sie das CMake-Buildsystem.Once the prerequisites are in place, and the download is verified, install the CMake build system.

  2. Suchen Sie den Tagnamen für das aktuelle Release des SDK.Find the tag name for the latest release of the SDK.

  3. Öffnen Sie eine Eingabeaufforderung oder die Git Bash-Shell.Open a command prompt or Git Bash shell. Führen Sie die folgenden Befehle zum Klonen des aktuellen Releases des Azure IoT C SDK-GitHub-Repositorys aus.Run the following commands to clone the latest release of the Azure IoT C SDK GitHub repository. Verwenden Sie das im vorherigen Schritt gefundene Tag als Wert für den Parameter -b:Use the tag you found in the previous step as the value for the -b parameter:

    git clone -b <release-tag> https://github.com/Azure/azure-iot-sdk-c.git
    cd azure-iot-sdk-c
    git submodule update --init
    

    Sie sollten damit rechnen, dass die Ausführung dieses Vorgangs mehrere Minuten in Anspruch nimmt.You should expect this operation to take several minutes to complete.

  4. Erstellen Sie ein cmake-Unterverzeichnis im Stammverzeichnis des Git-Repositorys, und navigieren Sie zu diesem Ordner.Create a cmake subdirectory in the root directory of the git repository, and navigate to that folder. Führen Sie die folgenden Befehle aus dem Verzeichnis azure-iot-sdk-c aus:Run the following commands from the azure-iot-sdk-c directory:

    mkdir cmake
    cd cmake
    
  5. Erstellen Sie mithilfe des folgenden Befehls eine spezifische SDK-Version für Ihre Entwicklungsclientplattform.Run the following command to build a version of the SDK specific to your development client platform. Im cmake-Verzeichnis wird eine Visual Studio-Projektmappe für das simulierte Gerät generiert.A Visual Studio solution for the simulated device will be generated in the cmake directory.

    cmake ..
    

    Wenn cmake Ihren C++-Compiler nicht findet, treten beim Ausführen des obigen Befehls unter Umständen Buildfehler auf.If cmake doesn't find your C++ compiler, you might get build errors while running the above command. Führen Sie den Befehl in diesem Fall an der Visual Studio-Eingabeaufforderung aus.If that happens, try running this command in the Visual Studio command prompt.

    Nach erfolgreicher Erstellung ähneln die letzten Ausgabezeilen der folgenden Ausgabe:Once the build succeeds, the last few output lines will look similar to the following output:

    $ cmake ..
    -- Building for: Visual Studio 15 2017
    -- Selecting Windows SDK version 10.0.16299.0 to target Windows 10.0.17134.
    -- The C compiler identification is MSVC 19.12.25835.0
    -- The CXX compiler identification is MSVC 19.12.25835.0
    
    ...
    
    -- Configuring done
    -- Generating done
    -- Build files have been written to: E:/IoT Testing/azure-iot-sdk-c/cmake
    

Erstellen eines IoT-HubsCreate an IoT hub

In diesem Abschnitt wird beschrieben, wie Sie über das Azure-Portal einen IoT-Hub erstellen:This section describes how to create an IoT hub using the Azure portal.

  1. Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal.

  2. Wählen Sie auf der Azure-Startseite die Schaltfläche + Ressource erstellen aus, und geben Sie dann ins Feld Marketplace durchsuchen den Begriff IoT Hub ein.From the Azure homepage, select the + Create a resource button, and then enter IoT Hub in the Search the Marketplace field.

  3. Wählen Sie in den Suchergebnissen IoT Hub und dann Erstellen aus.Select IoT Hub from the search results, and then select Create.

  4. Füllen Sie auf der Registerkarte Grundlegende Einstellungen die Felder wie folgt aus:On the Basics tab, complete the fields as follows:

    • Abonnement: Wählen Sie das Abonnement aus, das Sie für Ihren Hub verwenden möchten.Subscription: Select the subscription to use for your hub.

    • Ressourcengruppe: Wählen Sie eine vorhandene Ressourcengruppe aus, oder erstellen Sie eine neue.Resource Group: Select a resource group or create a new one. Wählen Sie zum Erstellen einer neuen Ressourcengruppe die Option Neu erstellen aus, und geben Sie den Namen ein, den Sie verwenden möchten.To create a new one, select Create new and fill in the name you want to use. Wenn Sie eine vorhandene Ressourcengruppe verwenden möchten, wählen Sie die entsprechende Ressourcengruppe aus.To use an existing resource group, select that resource group. Weitere Informationen finden Sie unter Verwalten von Azure Resource Manager-Ressourcengruppen.For more information, see Manage Azure Resource Manager resource groups.

    • Region: Wählen Sie die Region aus, in der sich Ihr Hub befinden soll.Region: Select the region in which you want your hub to be located. Wählen Sie den Standort aus, der Ihnen am nächsten ist.Select the location closest to you. Einige Features, etwa IoT Hub-Gerätestreams, sind nur in bestimmten Regionen verfügbar.Some features, such as IoT Hub device streams, are only available in specific regions. Für diese eingeschränkten Features müssen Sie eine der unterstützten Regionen auswählen.For these limited features, you must select one of the supported regions.

    • IoT Hub-Name: Geben Sie einen Namen für den Hub ein.IoT Hub Name: Enter a name for your hub. Dieser Name muss global eindeutig sein.This name must be globally unique. Wenn der eingegebene Name verfügbar ist, wird ein grünes Häkchen angezeigt.If the name you enter is available, a green check mark appears.

    Wichtig

    Der IoT-Hub ist öffentlich als DNS-Endpunkt ermittelbar. Stellen Sie daher sicher, dass Sie beim Vergeben des Namens keine sensiblen oder personenbezogenen Informationen verwenden.Because the IoT hub will be publicly discoverable as a DNS endpoint, be sure to avoid entering any sensitive or personally identifiable information when you name it.

    Erstellen eines Hubs im Azure-Portal

  5. Klicken Sie auf Weiter: Größe und Skalierung, um die Erstellung Ihres Hubs fortzusetzen.Select Next: Size and scale to continue creating your hub.

    Festlegen der Größe und Skalierung für einen neuen Hub über das Azure-Portal

    Sie können hier die Standardeinstellungen übernehmen.You can accept the default settings here. Sie können bei Bedarf die folgenden Felder anpassen:If desired, you can modify any of the following fields:

    • Tarif und Skalierung: Ihre ausgewählte Ebene.Pricing and scale tier: Your selected tier. Ihnen stehen abhängig davon, wie viele Features Sie verwenden und wie viele Nachrichten Sie über Ihre Lösung pro Tag senden möchten, mehrere Tarife zur Auswahl.You can choose from several tiers, depending on how many features you want and how many messages you send through your solution per day. Der kostenlose Tarif ist für Test und Bewertung vorgesehen.The free tier is intended for testing and evaluation. Damit kann für 500 Geräte eine Verbindung mit dem Hub hergestellt werden, und bis zu 8.000 Nachrichten pro Tag sind möglich.It allows 500 devices to be connected to the hub and up to 8,000 messages per day. Jedes Azure-Abonnement kann einen IoT-Hub im kostenlosen Tarif erstellen.Each Azure subscription can create one IoT hub in the free tier.

      Wenn Sie eine Schnellstartanleitung für IoT Hub-Gerätestreams durcharbeiten, wählen Sie den Free-Tarif aus.If you are working through a Quickstart for IoT Hub device streams, select the free tier.

    • IoT Hub-Einheiten: Die Anzahl der pro Einheit und Tag zulässigen Nachrichten hängt von Ihrem Hubtarif ab.IoT Hub units: The number of messages allowed per unit per day depends on your hub's pricing tier. Beispiel: Wenn der Hub 700.000 eingehende Nachrichten unterstützen soll, wählen Sie zwei Einheiten des Tarifs S1.For example, if you want the hub to support ingress of 700,000 messages, you choose two S1 tier units. Einzelheiten zu den anderen Tarifoptionen finden Sie unter Skalieren einer IoT Hub-Lösung.For details about the other tier options, see Choosing the right IoT Hub tier.

    • Azure Security Center: Aktivieren Sie diese Option, um IoT und Ihren Geräten eine zusätzliche Ebene für den Bedrohungsschutz hinzuzufügen.Azure Security Center: Turn this on to add an extra layer of threat protection to IoT and your devices. Diese Option steht nicht für Hubs im Free-Tarif zur Verfügung.This option is not available for hubs in the free tier. Weitere Informationen zu diesem Feature finden Sie in der Dokumentation zu Azure Security Center für IoT.For more information about this feature, see Azure Security Center for IoT.

    • Erweiterte Einstellungen > Gerät-zu-Cloud-Partitionen: Diese Eigenschaft setzt die Gerät-zu-Cloud-Nachrichten in Relation zur Anzahl von gleichzeitigen Lesern der Nachrichten.Advanced Settings > Device-to-cloud partitions: This property relates the device-to-cloud messages to the number of simultaneous readers of the messages. Die meisten Hubs benötigen nur vier Partitionen.Most hubs need only four partitions.

  6. Klicken Sie auf Weiter: Tags, um mit dem nächsten Bildschirm fortzufahren.Select Next: Tags to continue to the next screen.

    Tags sind Name-Wert-Paare.Tags are name/value pairs. Sie können das gleiche Tag mehreren Ressourcen und Ressourcengruppen zuweisen, um Ressourcen zu kategorisieren und die Abrechnung zu konsolidieren.You can assign the same tag to multiple resources and resource groups to categorize resources and consolidate billing. Weitere Informationen finden Sie unter Verwenden von Tags zum Organisieren von Azure-Ressourcen.For more information, see Use tags to organize your Azure resources.

    Zuweisen von Tags für den Hub über das Azure-Portal

  7. Klicken Sie auf Weiter: Überprüfen + erstellen, um Ihre Auswahl zu überprüfen.Select Next: Review + create to review your choices. Die Anzeige entspricht in etwa dem folgenden Bildschirm, allerdings werden die Werte verwendet, die Sie beim Erstellen des Hubs ausgewählt haben.You see something similar to this screen, but with the values you selected when creating the hub.

    Überprüfen von Informationen bei der Erstellung des neuen Hubs

  8. Wählen Sie Erstellen aus, um Ihren neuen Hub zu erstellen.Select Create to create your new hub. Das Erstellen des Hubs dauert einige Minuten.Creating the hub takes a few minutes.

Registrieren eines GerätsRegister a device

Ein Gerät muss bei Ihrer IoT Hub-Instanz registriert sein, um eine Verbindung herstellen zu können.A device must be registered with your IoT hub before it can connect. In diesem Abschnitt verwenden Sie Azure Cloud Shell mit der IoT-Erweiterung, um ein simuliertes Gerät zu registrieren.In this section, you'll use the Azure Cloud Shell with the IoT extension to register a simulated device.

  1. Führen Sie in Azure Cloud Shell den folgenden Befehl aus, um die Geräteidentität zu erstellen.Run the following command in Azure Cloud Shell to create the device identity.

    YourIoTHubName: Ersetzen Sie diesen Platzhalter unten durch den Namen, den Sie für Ihren IoT-Hub ausgewählt haben.YourIoTHubName: Replace this placeholder below with the name you chose for your IoT hub.

    MyCDevice: Der Name des Geräts, das Sie registrieren.MyCDevice: This is the name of the device you're registering. Es empfiehlt sich, MyCDevice wie gezeigt zu verwenden.It's recommended to use MyCDevice as shown. Wenn Sie für Ihr Gerät einen anderen Namen auswählen, müssen Sie diesen innerhalb des gesamten Artikels verwenden und den Gerätenamen in den Beispielanwendungen aktualisieren, bevor Sie sie ausführen.If you choose a different name for your device, you'll also need to use that name throughout this article, and update the device name in the sample applications before you run them.

    az iot hub device-identity create --hub-name {YourIoTHubName} --device-id MyCDevice
    
  2. Führen Sie den folgenden Befehl in Azure Cloud Shell aus, um die Geräteverbindungszeichenfolge für das soeben registrierte Gerät abzurufen:Run the following command in Azure Cloud Shell to get the device connection string for the device you just registered:

    YourIoTHubName: Ersetzen Sie diesen Platzhalter unten durch den Namen, den Sie für Ihren IoT-Hub ausgewählt haben.YourIoTHubName: Replace this placeholder below with the name you chose for your IoT hub.

    az iot hub device-identity show-connection-string --hub-name {YourIoTHubName} --device-id MyCDevice --output table
    

    Notieren Sie sich die Geräteverbindungszeichenfolge, die wie folgt aussieht:Make a note of the device connection string, which looks like:

    HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyCDevice;SharedAccessKey={YourSharedAccessKey}

    Dieser Wert wird später in der Schnellstartanleitung benötigt.You'll use this value later in the quickstart.

Senden simulierter TelemetriedatenSend simulated telemetry

Die Anwendung des simulierten Geräts stellt eine Verbindung mit einem gerätespezifischen Endpunkt in Ihrer IoT Hub-Instanz her und sendet simulierte Telemetriedaten in Form einer Zeichenfolge.The simulated device application connects to a device-specific endpoint on your IoT hub and sends a string as simulated telemetry.

  1. Öffnen Sie die Quelldatei „iothub_convenience_sample.c“ in einem Text-Editor, und überprüfen Sie den Beispielcode für das Senden von Telemetriedaten.Using a text editor, open the iothub_convenience_sample.c source file and review the sample code for sending telemetry. Die Datei befindet sich am folgenden Speicherort in dem Arbeitsverzeichnis, in dem Sie das Azure IoT C SDK geklont haben:The file is located in the following location under the working directory where you cloned the Azure IoT C SDK:

    azure-iot-sdk-c\iothub_client\samples\iothub_convenience_sample\iothub_convenience_sample.c
    
  2. Suchen Sie die Deklaration der Konstanten connectionString:Find the declaration of the connectionString constant:

    /* Paste in your device connection string  */
    static const char* connectionString = "[device connection string]";
    

    Ersetzen Sie den Wert der Konstanten connectionString durch die Geräteverbindungszeichenfolge, die Sie sich zuvor notiert haben.Replace the value of the connectionString constant with the device connection string you made a note of earlier. Speichern Sie Ihre Änderungen dann in iothub_convenience_sample.c.Then save your changes to iothub_convenience_sample.c.

  3. Navigieren Sie in einem lokalen Terminalfenster zum Projektverzeichnis iothub_convenience_sample in dem CMake-Verzeichnis, das Sie im Azure IoT C SDK erstellt haben.In a local terminal window, navigate to the iothub_convenience_sample project directory in the CMake directory that you created in the Azure IoT C SDK. Geben Sie den folgenden Befehl in Ihrem Arbeitsverzeichnis ein:Enter the following command from your working directory:

    cd azure-iot-sdk-c/cmake/iothub_client/samples/iothub_convenience_sample
    
  4. Führen Sie in Ihrem lokalen Terminalfenster CMake aus, um das Beispiel mit Ihrem aktualisierten Wert für connectionString zu erstellen:Run CMake in your local terminal window to build the sample with your updated connectionString value:

    cmake --build . --target iothub_convenience_sample --config Debug
    
  5. Führen Sie in Ihrem lokalen Terminalfenster den folgenden Befehl aus, um die simulierte Geräteanwendung auszuführen:In your local terminal window, run the following command to run the simulated device application:

    Debug\iothub_convenience_sample.exe
    

    Der folgende Screenshot zeigt die Ausgabe, während die simulierte Geräteanwendung Telemetriedaten an die IoT Hub-Instanz sendet:The following screenshot shows the output as the simulated device application sends telemetry to the IoT hub:

    Ausführen des simulierten Geräts

Lesen der Telemetriedaten aus Ihrem HubRead the telemetry from your hub

In diesem Abschnitt verwenden Sie Azure Cloud Shell mit der IoT-Erweiterung, um die Gerätenachrichten zu überwachen, die von dem simulierten Gerät gesendet werden.In this section, you'll use the Azure Cloud Shell with the IoT extension to monitor the device messages that are sent by the simulated device.

  1. Führen Sie über Azure Cloud Shell den folgenden Befehl aus, um eine Verbindung mit Ihrem IoT-Hub herzustellen und Nachrichten zu lesen:Using the Azure Cloud Shell, run the following command to connect and read messages from your IoT hub:

    YourIoTHubName: Ersetzen Sie diesen Platzhalter unten durch den Namen, den Sie für Ihren IoT-Hub wählen.YourIoTHubName: Replace this placeholder below with the name you choose for your IoT hub.

    az iot hub monitor-events --hub-name {YourIoTHubName} --output table
    

    Lesen der Gerätenachrichten mithilfe der Azure CLI

Bereinigen von RessourcenClean up resources

Falls Sie mit dem nächsten empfohlenen Artikel fortfahren möchten, können Sie die bereits erstellten Ressourcen behalten und wiederverwenden.If you will be continuing to the next recommended article, you can keep the resources you've already created and reuse them.

Andernfalls können Sie die in diesem Artikel erstellten Azure-Ressourcen löschen, um Kosten zu vermeiden.Otherwise, you can delete the Azure resources created in this article to avoid charges.

Wichtig

Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden.Deleting a resource group is irreversible. Die Ressourcengruppe und alle darin enthaltenen Ressourcen werden unwiderruflich gelöscht.The resource group and all the resources contained in it are permanently deleted. Achten Sie daher darauf, dass Sie nicht versehentlich die falsche Ressourcengruppe oder die falschen Ressourcen löschen.Make sure that you do not accidentally delete the wrong resource group or resources. Wenn Sie die IoT Hub-Ressource in einer bereits vorhandenen Ressourcengruppe erstellt haben, die Ressourcen enthält, die Sie behalten möchten, löschen Sie nicht die Ressourcengruppe, sondern nur die IoT Hub-Ressource.If you created the IoT Hub inside an existing resource group that contains resources you want to keep, only delete the IoT Hub resource itself instead of deleting the resource group.

So löschen Sie eine Ressourcengruppe anhand des Namens:To delete a resource group by name:

  1. Melden Sie sich beim Azure-Portal an, und klicken Sie auf Ressourcengruppen.Sign in to the Azure portal and select Resource groups.

  2. Geben Sie im Textfeld Nach Name filtern den Namen der Ressourcengruppe ein, die Ihre IoT Hub-Ressource enthält.In the Filter by name textbox, type the name of the resource group containing your IoT Hub.

  3. Wählen Sie in der Ergebnisliste rechts neben Ihrer Ressourcengruppe ... und dann Ressourcengruppe löschen aus.To the right of your resource group in the result list, select ... then Delete resource group.

    Löschen

  4. Sie werden aufgefordert, das Löschen der Ressourcengruppe zu bestätigen.You will be asked to confirm the deletion of the resource group. Geben Sie den Namen Ihrer Ressourcengruppe zur Bestätigung erneut ein, und wählen Sie Löschen aus.Type the name of your resource group again to confirm, and then select Delete. Daraufhin werden die Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht.After a few moments, the resource group and all of its contained resources are deleted.

Nächste SchritteNext steps

In dieser Schnellstartanleitung haben Sie einen IoT-Hub eingerichtet, ein Gerät registriert, mit einer C-Anwendung simulierte Telemetriedaten an den Hub gesendet und mithilfe von Azure Cloud Shell die Telemetriedaten aus dem Hub gelesen.In this quickstart, you set up an IoT hub, registered a device, sent simulated telemetry to the hub using a C application, and read the telemetry from the hub using the Azure Cloud Shell.

Weitere Informationen zum Entwickeln mit dem Azure IoT Hub C SDK finden Sie in der folgenden Schrittanleitung:To learn more about developing with the Azure IoT Hub C SDK, continue to the following How-to guide: