Поделиться через

az iot hub message-endpoint update

  • Предварительный просмотр
  • Ссылка

Примечание.

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.46.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot hub message-endpoint update . Подробнее о расширениях.

Группа команд "iot hub message-endpoint" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите свойства существующей конечной точки для Центр Интернета вещей.

Команды

Имя Описание Тип Состояние
az iot hub message-endpoint update cosmosdb-container

Обновите свойства существующей конечной точки контейнера Cosmos DB для Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-endpoint update eventhub

Обновите свойства существующей конечной точки Концентратора событий для Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-endpoint update servicebus-queue

Обновите свойства существующей конечной точки очереди служебная шина для Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-endpoint update servicebus-topic

Обновите свойства существующей конечной точки раздела служебная шина для Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-endpoint update storage-container

Обновите свойства существующей конечной точки контейнера хранилища для Центр Интернета вещей.

 Расширение Предварительный просмотр

az iot hub message-endpoint update cosmosdb-container

Предварительный просмотр

Группа команд "iot hub message-endpoint" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите свойства существующей конечной точки контейнера Cosmos DB для Центр Интернета вещей.

При обновлении типа проверки подлинности на основе ключа до конечной точки контейнера Cosmos DB на основе удостоверений необходимо указать удостоверение (через --identity) и uri конечной точки (через --endpoint-uri). Старый первичный ключ и вторичный ключ будут отключены.

При обновлении типа проверки подлинности с удостоверений до конечной точки контейнера Cosmos DB на основе ключей необходимо указать строка подключения (через --connection-string), первичный ключ (через --primary-key) или вторичный ключ (через ---secondary-key).

Невозможно изменить имя контейнера для конечной точки. Имена учетных записей можно изменять только в том случае, если контейнеры с одинаковым именем существуют в обеих учетных записях.

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]

Примеры

Обновите конечную точку контейнера Cosmos DB на основе ключей или на основе удостоверений, чтобы Центр Интернета вещей использовать новую указанную строка подключения.

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

Обновите конечную точку контейнера Cosmos DB для Центр Интернета вещей, чтобы использовать указанный первичный ключ и вторичный ключ.

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

Обновите конечную точку контейнера Cosmos DB для Центр Интернета вещей, чтобы использовать назначенное системой удостоверение и имя ключа секции. Шаблон ключа секции будет по умолчанию.

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

Обновите конечную точку контейнера Cosmos DB на основе ключа для Центр Интернета вещей, чтобы использовать назначенное пользователем удостоверение (можно пропустить URI --endpoint-URI, если конечная точка уже основана на удостоверениях).

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

Обязательные параметры

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации.

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--connection-string -c

Строка подключения конечной точки маршрутизации.

--database-name --db

Имя базы данных Cosmos DB в учетной записи Cosmos DB.

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

Группа ресурсов ресурса ресурса конечной точки. Если это не указано, будет использоваться группа ресурсов Центр Интернета вещей.

--endpoint-subscription-id -s

Идентификатор подписки ресурса конечной точки. Если это не указано, будет использоваться подписка Центр Интернета вещей.

--endpoint-uri

URI ресурса конечной точки.

--identity

Используйте управляемое удостоверение, назначаемое системой или назначаемое пользователем, для проверки подлинности конечной точки. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на удостоверение, назначаемое пользователем.

--partition-key-name --pkn

Имя ключа секции, связанного с этим контейнером SQL Cosmos DB, если он существует. Чтобы очистить это свойство, задайте значение "".

--partition-key-template --pkt

Шаблон для создания значения искусственного ключа секции для использования с этим контейнером SQL Cosmos DB. Шаблон должен содержать по крайней мере один из следующих заполнителей: {iothub}, {deviceid}, {DD}, {MM}и {ГГГГ}. Любой заполнитель может быть указан по крайней мере один раз, но порядок и компоненты, не являющиеся заполнителями, являются произвольными. Если указано имя ключа секции, шаблон ключа секции по умолчанию имеет значение {deviceid}-{ГГГГ}-{MM}. Чтобы очистить это свойство, задайте значение "".

--pk --primary-key

Первичный ключ учетной записи Cosmos DB.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--secondary-key --sk

Вторичный ключ учетной записи Cosmos DB.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-endpoint update eventhub

Предварительный просмотр

Группа команд "iot hub message-endpoint" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите свойства существующей конечной точки Концентратора событий для Центр Интернета вещей.

При обновлении типа проверки подлинности с ключа до конечной точки концентратора событий на основе удостоверений необходимо указать удостоверение (через --identity), uri конечной точки (через --endpoint-uri) и путь сущности (через --entity-path). Старый строка подключения будет иметь значение NULL.

При обновлении типа проверки подлинности с удостоверений до конечной точки концентратора событий на основе ключей необходимо указать строка подключения (через --connection-string). Старый uri конечной точки и путь сущности будет отключен.

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]

Примеры

Обновите конечную точку концентратора событий на основе ключей или на основе удостоверений, чтобы Центр Интернета вещей использовать новый указанный строка подключения.

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

Обновите конечную точку Концентратора событий для Центр Интернета вещей, чтобы использовать назначенное системой удостоверение и другой путь сущности.

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

Обновите конечную точку концентратора событий на основе ключей, чтобы Центр Интернета вещей использовать назначенное пользователем удостоверение (можно пропустить URI --endpoint-URI, если конечная точка уже основана на удостоверениях).

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}

Обязательные параметры

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации.

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--connection-string -c

Строка подключения конечной точки маршрутизации.

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

Группа ресурсов ресурса ресурса конечной точки. Если это не указано, будет использоваться группа ресурсов Центр Интернета вещей.

--endpoint-subscription-id -s

Идентификатор подписки ресурса конечной точки. Если это не указано, будет использоваться подписка Центр Интернета вещей.

--endpoint-uri

URI ресурса конечной точки.

--entity-path

Путь сущности ресурса конечной точки.

--identity

Используйте управляемое удостоверение, назначаемое системой или назначаемое пользователем, для проверки подлинности конечной точки. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на удостоверение, назначаемое пользователем.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-endpoint update servicebus-queue

Предварительный просмотр

Группа команд "iot hub message-endpoint" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите свойства существующей конечной точки очереди служебная шина для Центр Интернета вещей.

При обновлении типа проверки подлинности из ключа на конечную точку очереди на основе ключей служебная шина на основе удостоверений необходимо указать удостоверение (через --identity), uri конечной точки (через --endpoint-uri) и путь сущности (через --entity-path). Старый строка подключения будет иметь значение NULL.

При обновлении типа проверки подлинности с удостоверений на конечную точку очереди на основе ключей необходимо указать служебная шина строка подключения (через строку --connection-string). Старый uri конечной точки и путь сущности будет отключен.

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]

Примеры

Обновите конечную точку очереди служебная шина на основе ключей или на основе удостоверений, чтобы Центр Интернета вещей использовал новый указанный строка подключения.

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

Обновите конечную точку очереди служебная шина для Центр Интернета вещей, чтобы использовать назначенное системой удостоверение и другой путь сущности.

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

Обновите конечную точку очереди служебная шина на основе ключей для Центр Интернета вещей, чтобы использовать назначенное пользователем удостоверение (можно пропустить URI --endpoint-URI, если конечная точка уже основана на удостоверениях).

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}

Обязательные параметры

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации.

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--connection-string -c

Строка подключения конечной точки маршрутизации.

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

Группа ресурсов ресурса ресурса конечной точки. Если это не указано, будет использоваться группа ресурсов Центр Интернета вещей.

--endpoint-subscription-id -s

Идентификатор подписки ресурса конечной точки. Если это не указано, будет использоваться подписка Центр Интернета вещей.

--endpoint-uri

URI ресурса конечной точки.

--entity-path

Путь сущности ресурса конечной точки.

--identity

Используйте управляемое удостоверение, назначаемое системой или назначаемое пользователем, для проверки подлинности конечной точки. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на удостоверение, назначаемое пользователем.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-endpoint update servicebus-topic

Предварительный просмотр

Группа команд "iot hub message-endpoint" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите свойства существующей конечной точки раздела служебная шина для Центр Интернета вещей.

При обновлении типа проверки подлинности с ключа на конечную точку на основе удостоверений служебная шина Topic необходимо указать удостоверение (через --identity), uri конечной точки (через --endpoint-uri) и путь сущности (через --entity-path). Старый строка подключения будет иметь значение NULL.

При обновлении типа проверки подлинности на основе удостоверения до конечной точки служебная шина раздела на основе ключей необходимо указать строка подключения (через строку --connection-string). Старый uri конечной точки и путь сущности будет отключен.

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]

Примеры

Обновите конечную точку раздела служебная шина на основе ключей или на основе удостоверений, чтобы Центр Интернета вещей использовать новую указанную строка подключения.

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

Обновите конечную точку раздела служебная шина для Центр Интернета вещей, чтобы использовать назначенное системой удостоверение и другой путь сущности.

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

Обновите конечную точку раздела на основе ключей для служебная шина Центр Интернета вещей, чтобы использовать назначенное пользователем удостоверение (можно пропустить URI --endpoint-URI, если конечная точка уже основана на удостоверениях).

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}

Обязательные параметры

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации.

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--connection-string -c

Строка подключения конечной точки маршрутизации.

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

Группа ресурсов ресурса ресурса конечной точки. Если это не указано, будет использоваться группа ресурсов Центр Интернета вещей.

--endpoint-subscription-id -s

Идентификатор подписки ресурса конечной точки. Если это не указано, будет использоваться подписка Центр Интернета вещей.

--endpoint-uri

URI ресурса конечной точки.

--entity-path

Путь сущности ресурса конечной точки.

--identity

Используйте управляемое удостоверение, назначаемое системой или назначаемое пользователем, для проверки подлинности конечной точки. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на удостоверение, назначаемое пользователем.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-endpoint update storage-container

Предварительный просмотр

Группа команд "iot hub message-endpoint" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите свойства существующей конечной точки контейнера хранилища для Центр Интернета вещей.

При обновлении типа проверки подлинности с помощью ключа до конечной точки контейнера хранилища на основе удостоверений необходимо указать удостоверение (через --identity) и URI конечной точки (через --endpoint-uri). Старый строка подключения будет иметь значение NULL.

При обновлении типа проверки подлинности с удостоверений до конечной точки контейнера хранилища на основе ключей необходимо указать строка подключения (через строку --connection-string).

Невозможно изменить имя контейнера и кодировку для конечной точки. Имена учетных записей можно изменять только в том случае, если контейнеры с одинаковым именем существуют в обеих учетных записях.

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]

Примеры

Обновите конечную точку контейнера хранилища на основе ключей или на основе удостоверений для Центр Интернета вещей, чтобы использовать новую указанную строка подключения.

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

Обновите конечную точку контейнера хранилища для Центр Интернета вещей, чтобы использовать назначенное системой удостоверение с заданной частотой пакетной службы, размером блока и форматом имени файла.

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]

Обновите конечную точку контейнера хранилища на основе ключей для Центр Интернета вещей, чтобы использовать назначенное пользователем удостоверение (можно опустить --endpoint-URI, если конечная точка уже основана на удостоверениях).

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

Обязательные параметры

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации.

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--batch-frequency -b

Запрашивать частоту пакетной обработки в секундах. Максимальное время, которое может пройти до записи данных в большой двоичный объект в диапазоне от 60 до 720 секунд.

--chunk-size -w

Размер блока запроса в мегабайтах (МБ). Максимальный размер больших двоичных объектов в диапазоне от 10 до 500 МБ.

--connection-string -c

Строка подключения конечной точки маршрутизации.

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

Группа ресурсов ресурса ресурса конечной точки. Если это не указано, будет использоваться группа ресурсов Центр Интернета вещей.

--endpoint-subscription-id -s

Идентификатор подписки ресурса конечной точки. Если это не указано, будет использоваться подписка Центр Интернета вещей.

--endpoint-uri

URI ресурса конечной точки.

--ff --file-name-format

Формат имени файла для большого двоичного объекта. Формат имени файла должен содержать поля {iothub}, {partition}, {YYYY}, {MM}, {DD}, {HH} и {mm}. Все параметры являются обязательными, но могут быть переупорядочены с разделителями или без них.

--identity

Используйте управляемое удостоверение, назначаемое системой или назначаемое пользователем, для проверки подлинности конечной точки. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на удостоверение, назначаемое пользователем.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.