az iot central user

  • Ссылка

Примечание.

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

Управление и настройка пользователей IoT Central.

Команды

Имя Описание Тип Состояние
az iot central user create

Добавьте пользователя в приложение.

 Расширение Общедоступная версия
az iot central user delete

Удаление пользователя из приложения.

 Расширение Общедоступная версия
az iot central user list

Получение списка пользователей для приложения IoT Central.

 Расширение Общедоступная версия
az iot central user show

Получение сведений о пользователе по идентификатору.

 Расширение Общедоступная версия
az iot central user update

Обновите роли для пользователя в приложении.

 Расширение Общедоступная версия

az iot central user create

Добавьте пользователя в приложение.

az iot central user create --app-id
                           --assignee
                           --role
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--org-id]
                           [--tenant-id]
                           [--token]

Примеры

Добавление пользователя по электронной почте в приложение

az iot central user create --user-id {userId} --app-id {appId} --email {emailAddress} --role admin

Добавление субъекта-службы в приложение

az iot central user create --user-id {userId} --app-id {appId} --tenant-id {tenantId} --object-id {objectId} --role operator

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

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

--assignee --user-id

Идентификатор, связанный с пользователем.

--role -r

Роль, которая будет связана с этим токеном или пользователем. Можно указать одну из встроенных ролей или указать идентификатор роли пользовательской роли. Дополнительные возможности см. в статье .https://aka.ms/iotcentral-customrolesdocs

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

--api-version --av
Не рекомендуется

Аргумент "api_version" устарел и будет удален в будущем выпуске.

Этот параметр команды не рекомендуется использовать и будет игнорироваться. В будущем выпуске мы будем поддерживать только API IoT Central из последней версии общедоступной версии. Если любой API еще не является общедоступной, мы вызовем последнюю предварительную версию.

допустимые значения: 2022-06-30-preview, 2022-07-31
значение по умолчанию: 2022-07-31
--central-api-uri --central-dns-suffix

Суффикс DNS IoT Central, связанный с приложением.

значение по умолчанию: azureiotcentral.com
--email

Адрес электронной почты пользователя, добавляемого в приложение. Если это указано, параметры субъекта-службы (tenant_id и object_id) будут игнорироваться.

--object-id --oid

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

--org-id --organization-id

Идентификатор организации для назначения роли пользователя. Доступно только для api-version == 1.1-preview.

--tenant-id --tnid

Идентификатор клиента для добавления субъекта-службы в приложение. Также необходимо указать идентификатор объекта. Если указано сообщение электронной почты, это игнорируется, и пользователь не будет пользователем субъекта-службы, а стандартным пользователем электронной почты.

--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az iot central user delete

Удаление пользователя из приложения.

az iot central user delete --app-id
                           --assignee
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--token]

Примеры

Удаление пользователя

az iot central user delete --app-id {appid} --user-id {userId}

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

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

--assignee --user-id

Идентификатор, связанный с пользователем.

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

--api-version --av
Не рекомендуется

Аргумент "api_version" устарел и будет удален в будущем выпуске.

Этот параметр команды не рекомендуется использовать и будет игнорироваться. В будущем выпуске мы будем поддерживать только API IoT Central из последней версии общедоступной версии. Если любой API еще не является общедоступной, мы вызовем последнюю предварительную версию.

допустимые значения: 2022-06-30-preview, 2022-07-31
значение по умолчанию: 2022-07-31
--central-api-uri --central-dns-suffix

Суффикс DNS IoT Central, связанный с приложением.

значение по умолчанию: azureiotcentral.com
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az iot central user list

Получение списка пользователей для приложения IoT Central.

az iot central user list --app-id
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri]
                         [--token]

Примеры

Список пользователей

az iot central user list --app-id {appid}

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

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

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

--api-version --av
Не рекомендуется

Аргумент "api_version" устарел и будет удален в будущем выпуске.

Этот параметр команды не рекомендуется использовать и будет игнорироваться. В будущем выпуске мы будем поддерживать только API IoT Central из последней версии общедоступной версии. Если любой API еще не является общедоступной, мы вызовем последнюю предварительную версию.

допустимые значения: 2022-06-30-preview, 2022-07-31
значение по умолчанию: 2022-07-31
--central-api-uri --central-dns-suffix

Суффикс DNS IoT Central, связанный с приложением.

значение по умолчанию: azureiotcentral.com
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az iot central user show

Получение сведений о пользователе по идентификатору.

az iot central user show --app-id
                         --assignee
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri]
                         [--token]

Примеры

Получение сведений о пользователе

az iot central user show --app-id {appid} --user-id {userId}

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

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

--assignee --user-id

Идентификатор, связанный с пользователем.

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

--api-version --av
Не рекомендуется

Аргумент "api_version" устарел и будет удален в будущем выпуске.

Этот параметр команды не рекомендуется использовать и будет игнорироваться. В будущем выпуске мы будем поддерживать только API IoT Central из последней версии общедоступной версии. Если любой API еще не является общедоступной, мы вызовем последнюю предварительную версию.

допустимые значения: 2022-06-30-preview, 2022-07-31
значение по умолчанию: 2022-07-31
--central-api-uri --central-dns-suffix

Суффикс DNS IoT Central, связанный с приложением.

значение по умолчанию: azureiotcentral.com
--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az iot central user update

Обновите роли для пользователя в приложении.

Обновите пользователя с разными ролями. Обновление идентификатора клиента или objectId для пользователя субъекта-службы запрещено. Обновление адреса электронной почты для пользователя электронной почты запрещено.

az iot central user update --app-id
                           --assignee
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--roles]
                           [--tenant-id]
                           [--token]

Примеры

Обновите роли пользователя по электронной почте или субъекту-службе в приложении.

az iot central user update --user-id {userId} --app-id {appId} --roles "org1\admin"

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

--app-id -n

Идентификатор приложения IoT Central, которым требуется управлять. Идентификатор приложения можно найти на странице "О" для приложения в меню справки.

--assignee --user-id

Идентификатор, связанный с пользователем.

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

--api-version --av
Не рекомендуется

Аргумент "api_version" устарел и будет удален в будущем выпуске.

Этот параметр команды не рекомендуется использовать и будет игнорироваться. В будущем выпуске мы будем поддерживать только API IoT Central из последней версии общедоступной версии. Если любой API еще не является общедоступной, мы вызовем последнюю предварительную версию.

допустимые значения: 2022-06-30-preview, 2022-07-31
значение по умолчанию: 2022-07-31
--central-api-uri --central-dns-suffix

Суффикс DNS IoT Central, связанный с приложением.

значение по умолчанию: azureiotcentral.com
--email

Адрес электронной почты пользователя, добавляемого в приложение. Если это указано, параметры субъекта-службы (tenant_id и object_id) будут игнорироваться.

--object-id --oid

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

--roles

Разделенный запятыми список ролей, которые будут связаны с этим пользователем. Можно указать одну из встроенных ролей или указать идентификатор роли пользовательской роли. Дополнительные возможности см. в статье .https://aka.ms/iotcentral-customrolesdocs Организации могут быть указаны вместе с ролями при запуске с версией API == 1.1-preview. Например, "organization_id\role".

--tenant-id --tnid

Идентификатор клиента для добавления субъекта-службы в приложение. Также необходимо указать идентификатор объекта. Если указано сообщение электронной почты, это игнорируется, и пользователь не будет пользователем субъекта-службы, а стандартным пользователем электронной почты.

--token

Если вы хотите отправить запрос без проверки подлинности в Azure CLI, можно указать действительный маркер пользователя для проверки подлинности запроса. Необходимо указать тип ключа в рамках запроса. Узнайте больше по адресу https://aka.ms/iotcentraldocsapi.

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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