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

az iot hub state

  • Экспериментальный
  • Ссылка

Примечание.

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

Эта группа команд экспериментальна и находится в стадии разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Управление состоянием Центр Интернета вещей.

Дополнительные сведения см. в aka.ms/aziotcli-iot-hub-state.

Команды

Имя Описание Тип Состояние
az iot hub state export

Экспорт состояния Центр Интернета вещей в файл.

 Расширение Экспериментальный
az iot hub state import

Импорт состояния концентратора из файла в Центр Интернета вещей.

 Расширение Экспериментальный
az iot hub state migrate

Перенос состояния одного концентратора в другой, не сохраняя его в файл.

 Расширение Экспериментальный

az iot hub state export

Экспериментальный

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

Экспорт состояния Центр Интернета вещей в файл.

По умолчанию экспортируемое состояние будет включать в себя шаблон arm для концентратора, конфигураций концентратора (включая конфигурации ADM и пограничные развертывания), сведения об устройстве (включая идентификаторы устройств, двойники устройств, удостоверения модулей и двойники модулей).

Дополнительные сведения см. в aka.ms/aziotcli-iot-hub-state.

az iot hub state export --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Примеры

Экспортируйте поддерживаемое состояние указанного концентратора в указанный файл.

az iot hub state export -n {iothub_name} -f {state_filename}

Экспортируйте поддерживаемое состояние указанного концентратора в указанный файл, перезаписав содержимое файла.

az iot hub state export -n {iothub_name} -f {state_filename} -r

Экспортируйте только устройства и конфигурации указанного концентратора в указанный файл.

az iot hub state export -n {iothub_name} -f {state_filename} --aspects devices configurations

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

--state-file -f

Путь к файлу, в котором будут храниться сведения о состоянии.

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

--aspects

Аспекты концентратора (разделенные пробелами).

Допустимые значения: arm, configurations, devices
--auth-type

Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}.

Допустимые значения: key, login
Default value: key
--hub-name -n

Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.

--login -l

Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.

--replace -r

Если этот флаг задан, команда перезаписывает содержимое выходного файла.

Default value: False
--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 state import

Экспериментальный

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

Импорт состояния концентратора из файла в Центр Интернета вещей.

Если указан аспект руки, концентратор будет создан, если он не существует.

По умолчанию импортированное состояние будет включать в себя шаблон arm для концентратора, конфигураций концентратора (включая конфигурации ADM и пограничные развертывания), сведения об устройстве (включая идентификаторы устройств, двойники устройств, удостоверения модулей и двойники модулей).

Для импортированных конечных точек с проверкой подлинности назначаемого системой удостоверения указанный концентратор должен иметь правильные разрешения. В противном случае команда завершится ошибкой.

Частные конечные точки будут игнорироваться в процессе импорта.

Дополнительные сведения см. в aka.ms/aziotcli-iot-hub-state.

az iot hub state import --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Примеры

Импортируйте поддерживаемое состояние из указанного файла в указанный концентратор.

az iot hub state import -n {iothub_name} -f {state_filename}

Импортируйте поддерживаемое состояние из указанного файла в указанный концентратор, перезаписав предыдущее состояние концентратора. Все сертификаты, конфигурации и устройства будут удалены до отправки нового состояния.

az iot hub state import -n {iothub_name} -f {state_filename} -r

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

az iot hub state import -n {iothub_name} -g {resource_group} -f {state_filename} --aspects arm

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

az iot hub state import -n {iothub_name} -f {state_filename} --aspects devices configurations

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

--state-file -f

Путь к файлу, в котором будут храниться сведения о состоянии.

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

--aspects

Аспекты концентратора (разделенные пробелами).

Допустимые значения: arm, configurations, devices
--auth-type

Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}.

Допустимые значения: key, login
Default value: key
--hub-name -n

Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.

--login -l

Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.

--replace -r

Если этот флаг задан, команда удаляет текущие устройства, конфигурации и сертификаты целевого концентратора.

Default value: False
--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 state migrate

Экспериментальный

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

Перенос состояния одного концентратора в другой, не сохраняя его в файл.

Если указан аспект руки, концентратор будет создан, если он не существует.

По умолчанию перенесенное состояние будет включать в себя шаблон arm для концентратора, конфигураций концентратора (включая конфигурации ADM и пограничные развертывания), сведения об устройстве (включая идентификаторы устройств, двойники устройств, удостоверения модулей и двойники модулей).

Для перенесенных конечных точек с проверкой подлинности назначаемого системой удостоверения указанный концентратор должен иметь правильные разрешения. В противном случае команда завершится ошибкой.

Частные конечные точки будут игнорироваться в процессе миграции.

Если у вас возникли проблемы с миграцией, используйте команды экспорта и импорта, чтобы иметь файл в качестве резервной копии.

Дополнительные сведения см. в aka.ms/aziotcli-iot-hub-state.

az iot hub state migrate [--aspects {arm, configurations, devices}]
                         [--auth-type {key, login}]
                         [--destination-hub]
                         [--destination-hub-login]
                         [--destination-resource-group]
                         [--og]
                         [--oh]
                         [--ol]
                         [--replace]

Примеры

Перенесите поддерживаемое состояние центра-источника в целевой концентратор.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name}

Перенесите поддерживаемое состояние центра-источника в целевой концентратор, перезаписав предыдущее состояние концентратора. Все сертификаты, конфигурации и устройства в целевом центре будут удалены до отправки нового состояния.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} -r

Перенос только шаблона arm из исходного концентратора в целевой концентратор. Обратите внимание, что это создаст новый концентратор, если целевой концентратор не существует. Центр происхождения может содержать устройства и конфигурации, но они будут игнорироваться.

az iot hub state migrate --destination-hub {dest_hub_name} --destination-resource-group {dest_hub_resource_group} --origin-hub {orig_hub_name} --aspects arm

Перенос только устройств и конфигураций из исходного концентратора в целевой концентратор. Обратите внимание, что это не создаст новый концентратор, если целевой концентратор не существует, и команда завершится ошибкой. Шаблон arm для центра происхождения будет игнорироваться.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} --aspects devices configurations

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

--aspects

Аспекты концентратора (разделенные пробелами).

Допустимые значения: arm, configurations, devices
--auth-type

Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}.

Допустимые значения: key, login
Default value: key
--destination-hub --dh

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

--destination-hub-login --dl

Эта команда поддерживает строку подключения сущности с правами на выполнение действий в целевом концентраторе. Используйте для предотвращения входа в сеанс через az login для этого экземпляра Центра Интернета вещей. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если --destination-hub не указан.

--destination-resource-group --dg

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

--og --origin-resource-group

Имя группы ресурсов Центра Интернета вещей, которая будет скопирована.

--oh --origin-hub

Имя Центра Интернета вещей, который будет скопирован.

--ol --origin-hub-login

Эта команда поддерживает строку подключения сущности с правами на выполнение действия в концентраторе источника. Используйте для предотвращения входа в сеанс через az login для этого экземпляра Центра Интернета вещей. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если --origin-hub не указан.

--replace -r

Если этот флаг задан, команда удаляет текущие устройства, конфигурации и сертификаты целевого концентратора.

Default value: False
Глобальные параметры
--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.