Automatisch IoT-apparaat- en modulebeheer

Automatisch apparaatbeheer van Azure IoT Hub stroomlijnt het proces van het beheren van grote vloot apparaten door terugkerende en complexe taken te automatiseren. Met automatische apparaat- en moduleconfiguraties kunt u apparaten richten op basis van hun eigenschappen, gewenste instellingen opgeven en IoT Hub updates laten toepassen wanneer apparaten voldoen aan de gedefinieerde criteria. Met deze aanpak kunt u de configuratiestatus bewaken, conflicten oplossen en wijzigingen in fasen implementeren voor meer controle en naleving.

Opmerking

De functies die in dit artikel worden beschreven, zijn alleen beschikbaar in de standaardlaag van de IoT Hub. Zie De juiste IoT Hub-laag en -grootte kiezen voor uw oplossing voor meer informatie over de Basic- en Standard/gratis IoT Hub-lagen.

Overzicht van automatisch apparaatbeheer

Automatisch apparaatbeheer werkt door gewenste eigenschappen toe te passen op groepen apparaatdubbels of moduledubbels en resultaten samen te vatten met behulp van gerapporteerde eigenschappen. Dit proces maakt gebruik van een gespecialiseerd JSON-document met de naam Configuratie, dat uit drie hoofdonderdelen bestaat:

• De doelvoorwaarde definieert het bereik van apparaat-tweelingen of module-tweelingen die bijgewerkt moeten worden. De doelvoorwaarde wordt opgegeven als een query op dubbeltags en/of gerapporteerde eigenschappen.

• De doelinhoud definieert de gewenste kenmerken die moeten worden toegevoegd of bijgewerkt in de apparaattweelingen of moduletweelingen. De inhoud bevat een pad naar de sectie met gewenste eigenschappen die moeten worden gewijzigd.

• Het onderdeel met metrische gegevens bevat samenvattingen voor configuratiestatussen zoals Geslaagd, Wordt uitgevoerd en Fout. U kunt aangepaste metriek definiëren met behulp van query's op gerapporteerde eigenschappen van tweelingen, terwijl systeemmetriek de status van de update automatisch bijhoudt, inclusief hoeveel tweelingen worden gericht en hoeveel succesvol zijn bijgewerkt.

Automatische configuraties worden voor de eerste keer uitgevoerd kort nadat de configuratie is gemaakt en vervolgens met intervallen van vijf minuten. Metrische query's worden telkens uitgevoerd wanneer de automatische configuratie wordt uitgevoerd. Er worden maximaal 100 automatische configuraties ondersteund op IoT-hubs in de standard-laag; 10 op IoT-hubs in de gratis laag. Doseringslimieten zijn ook van toepassing. Zie Quota en beperking van IoT Hub voor meer informatie.

Vereiste voorwaarden

• Een actieve Azure-abonnement. Als je geen Azure-abonnement hebt, maak dan een gratis account aan voordat je begint.

• Een IoT-hub in uw Azure-abonnement. Als u nog geen hub hebt, kunt u de stappen volgen in de sectie Een IoT-hub maken van Azure IoT-hubs maken en beheren.

Tweelingen implementeren

Voor automatische apparaatconfiguraties is het gebruik van apparaatdubbels vereist om de status tussen de cloud en apparaten te synchroniseren. Zie Apparaatdubbels begrijpen en gebruiken in IoT Hub voor meer informatie.

Voor automatische moduleconfiguraties is het gebruik van moduledubbels vereist om de status tussen de cloud en modules te synchroniseren. Zie Moduledubbels begrijpen en gebruiken in IoT Hub voor meer informatie.

Tags gebruiken om je op tweelingen te richten

Voordat u een configuratie maakt, moet u opgeven welke apparaten of modules u wilt beïnvloeden. Azure IoT Hub identificeert apparaten met behulp van tags in de apparaatdubbel en identificeert modules met behulp van tags in de moduledubbel. Elk apparaat of elke module kan meerdere tags hebben en u kunt ze definiëren op elke manier die zinvol is voor uw oplossing. Als u bijvoorbeeld apparaten op verschillende locaties beheert, voegt u de volgende tags toe aan een apparaatdubbel:

"tags": {
    "location": {
        "state": "Washington",
        "city": "Tacoma"
    }
},

Een configuratie maken

U kunt maximaal 100 automatische configuraties maken op IoT-hubs in de standard-laag; 10 op IoT-hubs in de gratis laag. Zie Quota en beperking van IoT Hub voor meer informatie.

1. Ga in Azure Portal naar uw IoT-hub.

2. Selecteer Configuraties en implementaties in het servicemenu onder Apparaatbeheer.

3. Selecteer Toevoegen en kies Apparaatdubbelconfiguratie of Moduledubbelconfiguratie in de vervolgkeuzelijst.

   

Er zijn vijf stappen om een configuratie te maken. In de volgende secties wordt elke sectie afzonderlijk beschreven.

Naam en etiket

1. Voer een unieke naam in voor uw configuratie. De naam mag maximaal 128 tekens bevatten en kan kleine letters en de volgende speciale tekens bevatten: -+%_*!' Spaties zijn niet toegestaan.
2. Voeg labels toe om uw configuratie te organiseren en te beschrijven. Labels zijn sleutel-waardeparen, zoals HostPlatform, Linux of Version, 3.0.1.
3. Selecteer Volgende om door te gaan.

Gekoppelde instellingen

Stel de inhoud in de gewenste eigenschappen van de doelapparaatdubbel of moduledubbel in door twee invoer voor elke instelling op te geven. Geef eerst het twin-pad op, dat verwijst naar de JSON-sectie binnen de twin gewenste eigenschappen om bij te werken. Voer vervolgens de JSON-inhoud in die op die locatie moet worden ingevoegd.

U kunt bijvoorbeeld het tweelingpad instellen op properties.desired.chiller-water en vervolgens de volgende JSON-inhoud opgeven:

{
  "temperature": 66,
  "pressure": 28
}

U kunt ook afzonderlijke instellingen instellen door het hele dubbelpad op te geven en de waarde zonder vierkante haken op te geven. Stel bijvoorbeeld met het dubbelpad properties.desired.chiller-water.temperaturede inhoud in op 66. Maak vervolgens een nieuwe dubbelinstelling voor de drukeigenschap.

Als twee of meer configuraties zijn gericht op hetzelfde dubbelpad, is de inhoud van de configuratie met de hoogste prioriteit van toepassing (prioriteit wordt gedefinieerd in stap 4).

Als u een bestaande eigenschap wilt verwijderen, stelt u de eigenschapswaarde in op null.

U kunt meer instellingen toevoegen door de instelling Apparaatdubbel toevoegen of Moduledubbel-instelling toevoegen te selecteren.

Doelapparaten en modules

Gebruik de eigenschap tags van uw digitale tweelingen om te richten op de specifieke apparaten of modules die deze configuratie moeten ontvangen. U kunt zich ook richten op gerapporteerde eigenschappen van dubbele.

Automatische apparaatconfiguraties kunnen alleen gericht zijn op apparaat-tweelingtags en automatische moduleconfiguraties kunnen alleen gericht zijn op module-tweelingtags.

Omdat meerdere configuraties zich op hetzelfde apparaat of dezelfde module kunnen richten, heeft elke configuratie een prioriteitsnummer nodig. Als er ooit een conflict is, wint de configuratie met de hoogste prioriteit.

1. Voer een positief geheel getal in voor de configuratie Priority. De hoogste numerieke waarde wordt beschouwd als de hoogste prioriteit. Als twee configuraties hetzelfde prioriteitsnummer hebben, wint de configuratie die het laatst is gemaakt.

2. Voer een doelvoorwaarde in om te bepalen op welke apparaten of modules deze configuratie is gericht. De voorwaarde is gebaseerd op tweelinglabels of gerapporteerde tweelingeigenschappen en moet overeenkomen met het expressieformaat.

   • Voor automatische apparaatconfiguratie kunt u alleen de tag of gerapporteerde eigenschap opgeven voor het doel. Bijvoorbeeld tags.environment='test' of properties.reported.chillerProperties.model='4000x'. U kunt * opgeven om alle apparaten te targeten.

   • Voor automatische moduleconfiguratie gebruikt u een query om tags of gerapporteerde eigenschappen op te geven van de modules die zijn geregistreerd bij de IoT-hub. Bijvoorbeeld from devices.modules where tags.environment='test' of from devices.modules where properties.reported.chillerProperties.model='4000x'. Het jokerteken kan niet worden gebruikt om alle modules te targeten.

Statistieken

Metrische gegevens bieden samenvattingsaantallen van de verschillende statussen die een apparaat of module kan rapporteren na het toepassen van configuratie-inhoud. U kunt bijvoorbeeld een metriek maken voor instellingenwijzigingen in behandeling, een metriek voor fouten en een metriek voor geslaagde wijzigingen aan instellingen.

Elke configuratie kan maximaal vijf aangepaste metrische gegevens bevatten.

1. Voer een naam in voor metrieknaam.

2. Voer een query in voor metrische criteria. De query is gebaseerd op de gerapporteerde eigenschappen van de apparaat-tweeling. De metrische waarde vertegenwoordigt het aantal rijen dat door de query wordt geretourneerd.

   Voorbeeld:

   SELECT deviceId FROM devices 
     WHERE properties.reported.chillerWaterSettings.status='pending'
   

   U kunt een clausule opnemen waarin staat dat de configuratie is toegepast, bijvoorbeeld:

   /* Include the double brackets. */
   SELECT deviceId FROM devices 
     WHERE configurations.[[yourconfigname]].status='Applied'
   

   Als u een metrische waarde bouwt om te rapporteren over geconfigureerde modules, selecteert u moduleId in devices.modules. Voorbeeld:

   SELECT deviceId, moduleId FROM devices.modules
     WHERE properties.reported.lastDesiredStatus.code = 200
   

Configuratie controleren

Controleer uw configuratiegegevens en selecteer vervolgens Verzenden.

Een configuratie bewaken

Als u de details van een configuratie wilt bekijken en de apparaten wilt bewaken waarop deze wordt uitgevoerd, gebruikt u de volgende stappen:

1. Ga in Azure Portal naar uw IoT-hub.

2. Selecteer Configuraties en implementaties in het servicemenu onder Apparaatbeheer.

3. Controleer de configuratielijst. Voor elke configuratie kunt u de volgende details bekijken:

   • id : de naam van de configuratie.

   • doelvoorwaarde: de query die wordt gebruikt om doelapparaten of modules te definiëren.

   • Priority : het prioriteitsnummer dat aan de configuratie is toegewezen.

   • aanmaaktijd: de tijdstempel vanaf het moment waarop de configuratie is gemaakt. Deze tijdstempel wordt gebruikt om de banden te verbreken wanneer twee configuraties dezelfde prioriteit hebben.

   • Metrische systeemgegevens: metrische gegevens die worden berekend door IoT Hub en kunnen niet worden aangepast door ontwikkelaars. Targeted geeft het aantal device twins op dat overeenkomt met de doelvoorwaarde. Toepassen specificeert het aantal toestel-tweelingen dat door de configuratie wordt gewijzigd, wat gedeeltelijke wijzigingen kan omvatten als een afzonderlijke configuratie met een hogere prioriteit ook wijzigingen heeft aangebracht.

   • Aangepaste metrieken: metrieken die door de ontwikkelaar worden gespecificeerd als query's op gemelde eigenschappen van tweelingen. Er kunnen maximaal vijf aangepaste metrische gegevens per configuratie worden gedefinieerd.

4. Selecteer de configuratie die u wilt bewaken.

5. Controleer de configuratiedetails. U kunt tabbladen gebruiken om specifieke details weer te geven over de apparaten die de configuratie hebben ontvangen.

   • Doelapparaten of doelmodules : de apparaten of modules die overeenkomen met de doelvoorwaarde.

   • metrische gegevens: een lijst met metrische systeemgegevens en aangepaste metrische gegevens. U kunt een lijst met apparaten of modules weergeven die voor elke metriek worden geteld door de metrische waarde in de vervolgkeuzelijst te selecteren en vervolgens Apparaten weergeven of Modules weergeven te selecteren.

   • Labels - sleutel-waardeparen die worden gebruikt om een configuratie te beschrijven. Labels hebben geen invloed op functionaliteit.

   • nl-NL: Instellingen voor apparaatdubbels of moduledubbels: de dubbelinstellingen die zijn vastgesteld door de configuratie, indien van toepassing.

Een configuratie wijzigen

Wanneer u een configuratie wijzigt, worden de wijzigingen onmiddellijk gerepliceerd naar alle doelapparaten of modules.

Als u de doelvoorwaarde bijwerkt, worden de volgende updates uitgevoerd:

• Als een dubbel niet voldoet aan de oude doelvoorwaarde, maar voldoet aan de nieuwe doelvoorwaarde en deze configuratie de hoogste prioriteit voor die dubbel is, wordt deze configuratie toegepast.

• Als een tweeling waarop deze configuratie momenteel wordt uitgevoerd, niet meer voldoet aan de doelvoorwaarde, worden de instellingen uit de configuratie verwijderd en wordt de tweeling gewijzigd door de volgende configuratie met de hoogste prioriteit.

• Als een tweeling waarop deze configuratie momenteel wordt uitgevoerd niet meer voldoet aan de doelvoorwaarde en niet voldoet aan de doelvoorwaarde van andere configuraties, worden de instellingen uit de configuratie verwijderd en worden er geen andere wijzigingen aangebracht op de tweeling.

Als u een configuratie wilt wijzigen, gebruikt u de volgende stappen:

1. Ga in Azure Portal naar uw IoT-hub.
2. Selecteer Configuraties en implementaties in het servicemenu onder Apparaatbeheer.
3. Selecteer de configuratie die u wilt wijzigen.
4. U kunt de volgende velden bijwerken: prioriteit, metrische gegevens, doelvoorwaarde en labels.
5. Selecteer Opslaan.
6. Volg de stappen in Een configuratie bewaken om de uitrol van de wijzigingen te volgen.

Een configuratie verwijderen

Wanneer u een configuratie verwijdert, nemen alle apparaatkoppels de eerstvolgende configuratie met de hoogste prioriteit aan. Als apparaat-tweelingen niet voldoen aan de doelvoorwaarde van een andere configuratie, worden er geen verdere instellingen toegepast.

1. Ga in Azure Portal naar uw IoT-hub.
2. Selecteer Configuraties en implementaties in het servicemenu onder Apparaatbeheer.
3. Gebruik het selectievakje om de configuratie te selecteren die u wilt verwijderen.
4. Selecteer verwijderen.
5. U wordt gevraagd om de verwijdering te bevestigen.

Vereiste voorwaarden

• Een actieve Azure-abonnement. Als je geen Azure-abonnement hebt, maak dan een gratis account aan voordat je begint.

• Een IoT-hub in uw Azure-abonnement. Als u nog geen hub hebt, kunt u de stappen volgen in de sectie Een IoT-hub maken van Azure IoT-hubs maken en beheren.

• Azure CLI in uw omgeving. Uw Azure CLI-versie moet minimaal 2.0.70 of hoger zijn. Gebruik az –-version dit om te valideren. Deze versie ondersteunt az extension-opdrachten en introduceert het Knack-opdrachtframework.

• De IoT-extensie voor Azure CLI.

Opmerking

In dit artikel wordt de nieuwste versie van de Azure IoT-extensie gebruikt, die azure-iotwordt genoemd. De verouderde versie wordt aangeroepen azure-cli-iot-ext. U moet slechts één versie tegelijk hebben geïnstalleerd. U kunt de opdracht az extension list gebruiken om de momenteel geïnstalleerde extensies te valideren.

Gebruik az extension remove --name azure-cli-iot-ext om de verouderde versie van de extensie te verwijderen.

Gebruik az extension add --name azure-iot om de nieuwe versie van de extensie toe te voegen.

Als u wilt zien welke extensies momenteel zijn geïnstalleerd, gebruikt u az extension list.

Tweelingen implementeren

Voor automatische apparaatconfiguraties is het gebruik van apparaatdubbels vereist om de status tussen de cloud en apparaten te synchroniseren. Zie Apparaatdubbels begrijpen en gebruiken in IoT Hub voor meer informatie.

Voor automatische moduleconfiguraties is het gebruik van moduledubbels vereist om de status tussen de cloud en modules te synchroniseren. Zie Moduledubbels begrijpen en gebruiken in IoT Hub voor meer informatie.

Tags gebruiken om je op tweelingen te richten

Voordat u een configuratie maakt, moet u opgeven welke apparaten of modules u wilt beïnvloeden. Azure IoT Hub identificeert apparaten en gebruikt tags in de apparaatdubbel en identificeert modules met behulp van tags in de moduledubbel. Elk apparaat of elke module kan meerdere tags hebben en u kunt ze definiëren op elke manier die zinvol is voor uw oplossing. Als u bijvoorbeeld apparaten op verschillende locaties beheert, voegt u de volgende tags toe aan een apparaatdubbel:

"tags": {
	"location": {
		"state": "Washington",
		"city": "Tacoma"
    }
},

De doelinhoud en metrische gegevens definiëren

De doelinhoud en metrische query's worden opgegeven als JSON-documenten die de gewenste eigenschappen van de apparaat-twin of module-twin beschrijven, om eigenschappen in te stellen en gerapporteerde eigenschappen te meten. Als u een automatische configuratie wilt maken met behulp van Azure CLI, slaat u de doelinhoud en metrische gegevens lokaal op als .txt bestanden. U gebruikt de bestandspaden in een latere sectie wanneer u de opdracht uitvoert om de configuratie op uw apparaat toe te passen.

Hier volgt een eenvoudig voorbeeld van doelinhoud voor een automatische apparaatconfiguratie:

{
  "content": {
    "deviceContent": {
      "properties.desired.chillerWaterSettings": {
        "temperature": 38,
        "pressure": 78
      }
    }
  }
}

Automatische moduleconfiguraties gedragen zich op dezelfde manier, maar u richt zich op moduleContent in plaats van deviceContent.

{
  "content": {
    "moduleContent": {
      "properties.desired.chillerWaterSettings": {
        "temperature": 38,
        "pressure": 78
      }
    }
  }
}

Hier volgen voorbeelden van metrische query's:

{
  "queries": {
    "Compliant": "select deviceId from devices where configurations.[[chillerdevicesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='current'",
    "Error": "select deviceId from devices where configurations.[[chillerdevicesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='error'",
    "Pending": "select deviceId from devices where configurations.[[chillerdevicesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='pending'"
  }
}

Metrische query's voor modules zijn ook vergelijkbaar met query's voor apparaten, maar u selecteert hiervoor moduleIddevices.modules. Voorbeeld:

{
  "queries": {
    "Compliant": "select deviceId, moduleId from devices.module where configurations.[[chillermodulesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='current'"
  }
}

Een configuratie maken

U kunt maximaal 100 automatische configuraties maken op IoT-hubs in de standard-laag; 10 op IoT-hubs in de gratis laag. Zie Quota en beperking van IoT Hub voor meer informatie.

U configureert doelapparaten door een configuratie te maken die bestaat uit de doelinhoud en metrische gegevens. Gebruik de volgende opdracht om een configuratie te maken:

   az iot hub configuration create --config-id [configuration id] \
     --labels [labels] --content [file path] --hub-name [hub name] \
     --target-condition [target query] --priority [int] \
     --metrics [metric queries]

• -- config-id : de naam van de configuratie die is gemaakt in de IoT-hub. Geef uw configuratie een unieke naam die maximaal 128 tekens lang is. Kleine letters en de volgende speciale tekens zijn toegestaan: -+%_*!'. Spaties zijn niet toegestaan.

• -- labels : voeg labels toe om uw configuratie bij te houden. Labels zijn naam, waardeparen die uw implementatie beschrijven. Bijvoorbeeld HostPlatform, Linux of Version, 3.0.1

• -- inhoud : inline-JSON of bestandspad naar de doelinhoud die moet worden ingesteld als dubbele gewenste eigenschappen.

• -- hub-name : naam van de IoT-hub waarin de configuratie wordt gemaakt. De hub moet zich in het huidige abonnement bevinden. Overschakelen naar het gewenste abonnement met de opdracht az account set -s [subscription name]

• -- doelvoorwaarde: voer een doelvoorwaarde in om te bepalen welke apparaten of modules zijn gericht op deze configuratie. Voor automatische apparaatconfiguratie is de voorwaarde gebaseerd op apparaat-twin-tags of gewenste eigenschappen van de apparaat-twin en moet deze overeenkomen met het expressieformaat. Bijvoorbeeld tags.environment='test' of properties.desired.devicemodel='4000x'. Voor automatische moduleconfiguratie is de voorwaarde gebaseerd op module twin-tags of gewenste eigenschappen van het module twin-model. Bijvoorbeeld from devices.modules where tags.environment='test' of from devices.modules where properties.reported.chillerProperties.model='4000x'.

• -- prioriteit : een positief geheel getal. Als twee of meer configuraties zijn gericht op hetzelfde apparaat of dezelfde module, is de configuratie met de hoogste numerieke waarde voor Prioriteit van toepassing.

• -- metriek - Bestandspad naar de metrische queries. Metrische gegevens bieden samenvattingsaantallen van de verschillende statussen die een apparaat of module kan rapporteren na het toepassen van configuratie-inhoud. U kunt bijvoorbeeld een metrische waarde maken voor wijzigingen in wachtende instellingen, een metrische waarde voor fouten en een metrische waarde voor geslaagde instellingenwijzigingen.

Een configuratie bewaken

Gebruik de volgende opdracht om de inhoud van een configuratie weer te geven:

az iot hub configuration show --config-id [configuration id] \
  --hub-name [hub name]

• -- config-id : de naam van de configuratie die bestaat in de IoT-hub.

• -- hub-name : naam van de IoT-hub waarin de configuratie bestaat. De hub moet zich in het huidige abonnement bevinden. Schakel over naar het gewenste abonnement met de opdracht az account set -s [subscription name].

Controleer de configuratie in het opdrachtvenster. De eigenschap metrische gegevens bevat een telling voor elke metrische waarde die door elke hub wordt geëvalueerd:

• targetedCount : een systeemmetriek waarmee het aantal apparaatdubbels of moduledubbels in IoT Hub wordt opgegeven die overeenkomen met de doelvoorwaarde.

• appliedCount - Een systeemmetriek geeft het aantal apparaten of modules aan waarop de doelinhoud is toegepast.

• Uw aangepaste metrische gegevens : alle metrische gegevens die u hebt gedefinieerd, zijn metrische gegevens van gebruikers.

U kunt een lijst met apparaat-id's, module-id's of objecten voor elk van de metrische gegevens weergeven met behulp van de volgende opdracht:

az iot hub configuration show-metric --config-id [configuration id] \
   --metric-id [metric id] --hub-name [hub name] --metric-type [type] 

• -- config-id : de naam van de implementatie die bestaat in de IoT-hub.

• -- metric-id : de naam van de metrische waarde waarvoor u de lijst met apparaat-id's of module-id's wilt zien, bijvoorbeeld appliedCount.

• -- hub-name : naam van de IoT-hub waarin de implementatie bestaat. De hub moet zich in het huidige abonnement bevinden. Schakel over naar het gewenste abonnement met de opdracht az account set -s [subscription name].

• -- metrisch type - Het metrisch type kan system of user zijn. Metrische systeemgegevens zijn targetedCount en appliedCount. Alle andere metrische gegevens zijn metrische gegevens van gebruikers.

Een configuratie wijzigen

Wanneer u een configuratie wijzigt, worden de wijzigingen onmiddellijk gerepliceerd naar alle doelapparaten.

Als u de doelvoorwaarde bijwerkt, worden de volgende updates uitgevoerd:

• Als een dubbel niet voldoet aan de oude doelvoorwaarde, maar voldoet aan de nieuwe doelvoorwaarde en deze configuratie de hoogste prioriteit voor die dubbel is, wordt deze configuratie toegepast.

• Als een tweeling waarop deze configuratie momenteel wordt uitgevoerd, niet meer voldoet aan de doelvoorwaarde, worden de instellingen uit de configuratie verwijderd en wordt de tweeling gewijzigd door de volgende configuratie met de hoogste prioriteit.

• Als een tweeling waarop deze configuratie momenteel wordt uitgevoerd niet meer voldoet aan de doelvoorwaarde en niet voldoet aan de doelvoorwaarde van andere configuraties, worden de instellingen uit de configuratie verwijderd en worden er geen andere wijzigingen aangebracht op de tweeling.

Gebruik de volgende opdracht om een configuratie bij te werken:

az iot hub configuration update --config-id [configuration id] \
   --hub-name [hub name] --set [property1.property2='value']

• -- config-id : de naam van de configuratie die bestaat in de IoT-hub.

• -- hub-name : naam van de IoT-hub waarin de configuratie bestaat. De hub moet zich in het huidige abonnement bevinden. Schakel over naar het gewenste abonnement met de opdracht az account set -s [subscription name].

• -- set - Een eigenschap bijwerken in de configuratie. U kunt de volgende eigenschappen bijwerken:

  • targetCondition - bijvoorbeeld targetCondition=tags.location.state='Oregon'

  • labels

  • priority

Een configuratie verwijderen

Wanneer u een configuratie verwijdert, hebben alle apparaatdubbels of moduledubbels hun volgende configuratie met de hoogste prioriteit. Als tweelingen niet voldoen aan de doelvoorwaarde van een andere configuratie, worden er geen andere instellingen toegepast.

Gebruik de volgende opdracht om een configuratie te verwijderen:

az iot hub configuration delete --config-id [configuration id] \
   --hub-name [hub name] 

• -- config-id : de naam van de configuratie die bestaat in de IoT-hub.

• -- hub-name : naam van de IoT-hub waarin de configuratie bestaat. De hub moet zich in het huidige abonnement bevinden. Schakel over naar het gewenste abonnement met de opdracht az account set -s [subscription name].

Volgende stappen

In dit artikel hebt u geleerd hoe u IoT-apparaten op schaal configureert en bewaakt.

Zie IoT Hub-apparaatidentiteiten bulksgewijs importeren en exporteren voor meer informatie over het bulksgewijs beheren van IoT Hub-apparaatidentiteiten