Delen via

az iot hub message-endpoint update

  • Preview
  • Referentie

Notitie

Deze verwijzing maakt deel uit van de azure-iot--extensie voor de Azure CLI (versie 2.46.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot hub message-endpoint update opdracht uitvoert. Meer informatie over extensies.

Opdrachtgroep 'iot hub message-endpoint' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de eigenschappen van een bestaand eindpunt voor een IoT Hub bij.

Opdracht

Name Description Type Status
az iot hub message-endpoint update cosmosdb-container

Werk de eigenschappen van een bestaand Cosmos DB-containereindpunt voor een IoT Hub bij.

 Uitbreiding Voorbeeld
az iot hub message-endpoint update eventhub

Werk de eigenschappen van een bestaand Event Hub-eindpunt voor een IoT Hub bij.

 Uitbreiding Voorbeeld
az iot hub message-endpoint update servicebus-queue

Werk de eigenschappen van een bestaand Service Bus-wachtrij-eindpunt voor een IoT Hub bij.

 Uitbreiding Voorbeeld
az iot hub message-endpoint update servicebus-topic

Werk de eigenschappen van een bestaand Service Bus-onderwerpeindpunt voor een IoT Hub bij.

 Uitbreiding Voorbeeld
az iot hub message-endpoint update storage-container

Werk de eigenschappen van een bestaand opslagcontainereindpunt voor een IoT Hub bij.

 Uitbreiding Voorbeeld

az iot hub message-endpoint update cosmosdb-container

Preview

Opdrachtgroep 'iot hub message-endpoint' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de eigenschappen van een bestaand Cosmos DB-containereindpunt voor een IoT Hub bij.

Als u het verificatietype bijwerkt van een sleutel naar een cosmos DB-containereindpunt op basis van identiteit, moet u de identiteit (via --identity) en de eindpunt-URI (via --endpoint-uri) opgeven. De oude primaire sleutel en secundaire sleutel worden null-out.

Als u het verificatietype bijwerkt van een identiteit naar een cosmos DB-containereindpunt op basis van een sleutel, moet u de verbindingsreeks opgeven (via --connection-string), de primaire sleutel (via --primary-key) of de secundaire sleutel (via --secundaire sleutel).

De containernaam voor het eindpunt kan niet worden gewijzigd. Accountnamen kunnen alleen worden gewijzigd als containers met dezelfde naam in beide accounts bestaan.

az iot hub message-endpoint update cosmosdb-container --en
                                                      --hub-name
                                                      [--connection-string]
                                                      [--database-name]
                                                      [--endpoint-resource-group]
                                                      [--endpoint-subscription-id]
                                                      [--endpoint-uri]
                                                      [--identity]
                                                      [--partition-key-name]
                                                      [--partition-key-template]
                                                      [--pk]
                                                      [--resource-group]
                                                      [--secondary-key]

Voorbeelden

Werk een cosmos DB-containereindpunt op basis van sleutels of identiteiten bij voor een IoT Hub om een nieuwe opgegeven verbindingsreeks te gebruiken.

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --connection-string {connection_string}

Werk een Cosmos DB-containereindpunt voor een IoT Hub bij om een opgegeven primaire sleutel en secundaire sleutel te gebruiken.

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pk {primary_key} --sk {secondary_key}

Werk een Cosmos DB-containereindpunt voor een IoT Hub bij om een door het systeem toegewezen identiteit en een partitiesleutelnaam te gebruiken. De partitiesleutelsjabloon is de standaardwaarde.

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pkn {partition_key_name} --identity [system]

Werk een cosmos DB-containereindpunt op basis van een sleutel bij voor een IoT Hub om een door de gebruiker toegewezen identiteit te gebruiken (u kunt --endpoint-uri weglaten als het eindpunt al op identiteit is gebaseerd).

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}

Vereiste parameters

--en --endpoint --endpoint-name

Naam van het routeringseindpunt.

--hub-name -n

Naam van IoT Hub.

Optionele parameters

--connection-string -c

Verbindingsreeks van het routeringseindpunt.

--database-name --db

De naam van de cosmos DB-database in het cosmos DB-account.

--endpoint-resource-group --erg -r

Resourcegroep van de eindpuntresources. Indien niet opgegeven, wordt de resourcegroep van de IoT Hub gebruikt.

--endpoint-subscription-id -s

Abonnements-id van de eindpuntresource. Als dit niet is opgegeven, wordt het abonnement van de IoT Hub gebruikt.

--endpoint-uri

De URI van de eindpuntresource.

--identity

Gebruik een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit voor eindpuntverificatie. Gebruik [system]' om te verwijzen naar de door het systeem toegewezen identiteit of een resource-id om te verwijzen naar een door de gebruiker toegewezen identiteit.

--partition-key-name --pkn

De naam van de partitiesleutel die is gekoppeld aan deze Cosmos DB SQL-container, indien aanwezig. Als u deze eigenschap wilt wissen, stelt u deze in op ''.

--partition-key-template --pkt

De sjabloon voor het genereren van een synthetische partitiesleutelwaarde voor gebruik met deze Cosmos DB SQL-container. De sjabloon moet ten minste een van de volgende tijdelijke aanduidingen bevatten: {iothub}, {deviceid}, {DD}, {MM} en {JJJJ}. Elke tijdelijke aanduiding kan maximaal één keer worden opgegeven, maar volgorde en niet-tijdelijke aanduidingen zijn willekeurig. Als de naam van de partitiesleutel is opgegeven, wordt de partitiesleutelsjabloon standaard ingesteld op {deviceid}-{JJJJ}-{MM}. Als u deze eigenschap wilt wissen, stelt u deze in op ''.

--pk --primary-key

De primaire sleutel van het Cosmos DB-account.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--secondary-key --sk

De secundaire sleutel van het cosmos DB-account.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub message-endpoint update eventhub

Preview

Opdrachtgroep 'iot hub message-endpoint' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de eigenschappen van een bestaand Event Hub-eindpunt voor een IoT Hub bij.

Als u het verificatietype bijwerkt van een op een sleutel gebaseerd op een Event Hub-eindpunt op basis van identiteit, moet u de identiteit (via --identity), de eindpunt-URI (via --endpoint-uri) en het entiteitspad (via --entity-path) opgeven. De oude verbindingsreeks wordt null-out.

Als u het verificatietype bijwerkt van een op identiteit gebaseerd op een Event Hub-eindpunt op basis van een sleutel, moet u de verbindingsreeks opgeven (via --connection-string). De oude eindpunt-URI en het entiteitspad worden null-out.

az iot hub message-endpoint update eventhub --en
                                            --hub-name
                                            [--connection-string]
                                            [--endpoint-resource-group]
                                            [--endpoint-subscription-id]
                                            [--endpoint-uri]
                                            [--entity-path]
                                            [--identity]
                                            [--resource-group]

Voorbeelden

Werk een Event Hub-eindpunt op basis van sleutels of identiteiten bij voor een IoT Hub om een nieuwe opgegeven verbindingsreeks te gebruiken.

az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} -c {connection_string}

Werk een Event Hub-eindpunt voor een IoT Hub bij om een door het systeem toegewezen identiteit en een ander entiteitspad te gebruiken.

az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]

Werk een event hub-eindpunt op basis van sleutels bij voor een IoT Hub om een door de gebruiker toegewezen identiteit te gebruiken (u kunt --endpoint-uri weglaten als het eindpunt al op identiteit is gebaseerd).

az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}

Vereiste parameters

--en --endpoint --endpoint-name

Naam van het routeringseindpunt.

--hub-name -n

Naam van IoT Hub.

Optionele parameters

--connection-string -c

Verbindingsreeks van het routeringseindpunt.

--endpoint-resource-group --erg -r

Resourcegroep van de eindpuntresources. Indien niet opgegeven, wordt de resourcegroep van de IoT Hub gebruikt.

--endpoint-subscription-id -s

Abonnements-id van de eindpuntresource. Als dit niet is opgegeven, wordt het abonnement van de IoT Hub gebruikt.

--endpoint-uri

De URI van de eindpuntresource.

--entity-path

Het entiteitspad van de eindpuntresource.

--identity

Gebruik een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit voor eindpuntverificatie. Gebruik [system]' om te verwijzen naar de door het systeem toegewezen identiteit of een resource-id om te verwijzen naar een door de gebruiker toegewezen identiteit.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub message-endpoint update servicebus-queue

Preview

Opdrachtgroep 'iot hub message-endpoint' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de eigenschappen van een bestaand Service Bus-wachtrij-eindpunt voor een IoT Hub bij.

Als u het verificatietype bijwerkt van een sleutel naar een service bus-wachtrijeindpunt op basis van identiteit, moet u de identiteit opgeven (via --identity), de eindpunt-URI (via --endpoint-uri) en het entiteitspad (via --entity-path). De oude verbindingsreeks wordt null-out.

Als u het verificatietype bijwerkt van een identiteit naar het eindpunt van de Service Bus-wachtrij op basis van een sleutel, moet u de verbindingsreeks opgeven (via --connection-string). De oude eindpunt-URI en het entiteitspad worden null-out.

az iot hub message-endpoint update servicebus-queue --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Voorbeelden

Werk een servicebuswachtrijeindpunt op basis van sleutels of identiteiten bij voor een IoT Hub om een nieuwe opgegeven verbindingsreeks te gebruiken.

az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} -c {connection_string}

Werk een Service Bus-wachtrij-eindpunt bij voor een IoT Hub om een door het systeem toegewezen identiteit en een ander entiteitspad te gebruiken.

az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]

Werk een service bus-wachtrijeindpunt op basis van sleutels bij voor een IoT Hub om een door de gebruiker toegewezen identiteit te gebruiken (u kunt --endpoint-uri weglaten als het eindpunt al op identiteit is gebaseerd).

az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}

Vereiste parameters

--en --endpoint --endpoint-name

Naam van het routeringseindpunt.

--hub-name -n

Naam van IoT Hub.

Optionele parameters

--connection-string -c

Verbindingsreeks van het routeringseindpunt.

--endpoint-resource-group --erg -r

Resourcegroep van de eindpuntresources. Indien niet opgegeven, wordt de resourcegroep van de IoT Hub gebruikt.

--endpoint-subscription-id -s

Abonnements-id van de eindpuntresource. Als dit niet is opgegeven, wordt het abonnement van de IoT Hub gebruikt.

--endpoint-uri

De URI van de eindpuntresource.

--entity-path

Het entiteitspad van de eindpuntresource.

--identity

Gebruik een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit voor eindpuntverificatie. Gebruik [system]' om te verwijzen naar de door het systeem toegewezen identiteit of een resource-id om te verwijzen naar een door de gebruiker toegewezen identiteit.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub message-endpoint update servicebus-topic

Preview

Opdrachtgroep 'iot hub message-endpoint' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de eigenschappen van een bestaand Service Bus-onderwerpeindpunt voor een IoT Hub bij.

Als u het verificatietype bijwerkt van een sleutel naar een service Bus-onderwerpeindpunt op basis van identiteit, moet u de identiteit opgeven (via --identity), de eindpunt-URI (via --endpoint-uri) en het entiteitspad (via --entity-path). De oude verbindingsreeks wordt null-out.

Als u het verificatietype bijwerkt van een op identiteit gebaseerd op een service Bus-onderwerpeindpunt op basis van een sleutel, moet u de verbindingsreeks opgeven (via --connection-string). De oude eindpunt-URI en het entiteitspad worden null-out.

az iot hub message-endpoint update servicebus-topic --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Voorbeelden

Werk een service bus-onderwerpeindpunt op basis van sleutels of identiteiten bij voor een IoT Hub om een nieuwe opgegeven verbindingsreeks te gebruiken.

az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} -c {connection_string}

Werk een Service Bus-onderwerpeindpunt bij voor een IoT Hub om een door het systeem toegewezen identiteit en een ander entiteitspad te gebruiken.

az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]

Werk een service bus-onderwerpeindpunt op basis van sleutels bij voor een IoT Hub om een door de gebruiker toegewezen identiteit te gebruiken (u kunt --endpoint-uri weglaten als het eindpunt al op identiteit is gebaseerd).

az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name}  --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}

Vereiste parameters

--en --endpoint --endpoint-name

Naam van het routeringseindpunt.

--hub-name -n

Naam van IoT Hub.

Optionele parameters

--connection-string -c

Verbindingsreeks van het routeringseindpunt.

--endpoint-resource-group --erg -r

Resourcegroep van de eindpuntresources. Indien niet opgegeven, wordt de resourcegroep van de IoT Hub gebruikt.

--endpoint-subscription-id -s

Abonnements-id van de eindpuntresource. Als dit niet is opgegeven, wordt het abonnement van de IoT Hub gebruikt.

--endpoint-uri

De URI van de eindpuntresource.

--entity-path

Het entiteitspad van de eindpuntresource.

--identity

Gebruik een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit voor eindpuntverificatie. Gebruik [system]' om te verwijzen naar de door het systeem toegewezen identiteit of een resource-id om te verwijzen naar een door de gebruiker toegewezen identiteit.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot hub message-endpoint update storage-container

Preview

Opdrachtgroep 'iot hub message-endpoint' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Werk de eigenschappen van een bestaand opslagcontainereindpunt voor een IoT Hub bij.

Als u het verificatietype bijwerkt van een sleutel naar een opslagcontainereindpunt op basis van identiteit, moet u de identiteit (via --identity) en de eindpunt-URI (via --endpoint-uri) opgeven. De oude verbindingsreeks wordt null-out.

Als u het verificatietype bijwerkt van een op identiteit gebaseerde opslagcontainereindpunt op basis van een sleutel, moet u de verbindingsreeks opgeven (via --connection-string).

Containernaam en codering voor het eindpunt kunnen niet worden gewijzigd. Accountnamen kunnen alleen worden gewijzigd als containers met dezelfde naam in beide accounts bestaan.

az iot hub message-endpoint update storage-container --en
                                                     --hub-name
                                                     [--batch-frequency]
                                                     [--chunk-size]
                                                     [--connection-string]
                                                     [--endpoint-resource-group]
                                                     [--endpoint-subscription-id]
                                                     [--endpoint-uri]
                                                     [--ff]
                                                     [--identity]
                                                     [--resource-group]

Voorbeelden

Werk een opslagcontainereindpunt op basis van sleutels of identiteiten bij voor een IoT Hub om een nieuwe opgegeven verbindingsreeks te gebruiken.

az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} -c {connection_string}

Werk een opslagcontainereindpunt voor een IoT Hub bij om een door het systeem toegewezen identiteit te gebruiken met de opgegeven batchfrequentie, segmentgrootte en bestandsindeling.

az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name}  -b {batch_frequency} -w {chunk_size} --ff {file_format} --identity [system]

Werk een opslagcontainereindpunt op basis van een sleutel bij voor een IoT Hub om een door de gebruiker toegewezen identiteit te gebruiken (u kunt --endpoint-uri weglaten als het eindpunt al op identiteit is gebaseerd).

az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}

Vereiste parameters

--en --endpoint --endpoint-name

Naam van het routeringseindpunt.

--hub-name -n

Naam van IoT Hub.

Optionele parameters

--batch-frequency -b

Aanvraag batchfrequentie in seconden. De maximale hoeveelheid tijd die kan worden verstreken voordat gegevens naar een blob worden geschreven, tussen 60 en 720 seconden.

--chunk-size -w

Grootte van segmenten aanvragen in megabytes (MB). De maximale grootte van blobs, tussen 10 en 500 MB.

--connection-string -c

Verbindingsreeks van het routeringseindpunt.

--endpoint-resource-group --erg -r

Resourcegroep van de eindpuntresources. Indien niet opgegeven, wordt de resourcegroep van de IoT Hub gebruikt.

--endpoint-subscription-id -s

Abonnements-id van de eindpuntresource. Als dit niet is opgegeven, wordt het abonnement van de IoT Hub gebruikt.

--endpoint-uri

De URI van de eindpuntresource.

--ff --file-name-format

Bestandsnaamindeling voor de blob. De bestandsindeling moet de velden {iothub}, {partition}, {JJJJ}, {MM}, {DD}, {HH} en {mm} bevatten. Alle parameters zijn verplicht, maar kunnen opnieuw worden gerangschikt met of zonder scheidingstekens.

--identity

Gebruik een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit voor eindpuntverificatie. Gebruik [system]' om te verwijzen naar de door het systeem toegewezen identiteit of een resource-id om te verwijzen naar een door de gebruiker toegewezen identiteit.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.