az iot central user

Poznámka

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.37.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot central user . Přečtěte si další informace o rozšířeních.

Správa a konfigurace uživatelů IoT Central

Příkazy

Name Description Typ Stav
az iot central user create

Přidejte uživatele do aplikace.

Rozšíření GA
az iot central user delete

Odstraňte uživatele z aplikace.

Rozšíření GA
az iot central user list

Získejte seznam uživatelů pro aplikaci IoT Central.

Rozšíření GA
az iot central user show

Získejte podrobnosti o uživateli podle ID.

Rozšíření GA
az iot central user update

Aktualizujte role pro uživatele v aplikaci.

Rozšíření GA

az iot central user create

Přidejte uživatele do aplikace.

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]

Příklady

Přidání uživatele e-mailem do aplikace

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

Přidání instančního objektu do aplikace

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

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--assignee --user-id

ID přidružené k uživateli.

--role -r

Role, která bude přidružená k tomuto tokenu nebo uživateli. Můžete zadat jednu z předdefinovaných rolí nebo zadat ID role vlastní role. Další informace najdete na adrese https://aka.ms/iotcentral-customrolesdocs.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--email

E-mailová adresa uživatele, který se má přidat do aplikace Pokud je tento parametr zadán, budou parametry instančního objektu (tenant_id a object_id) ignorovány.

--object-id --oid

ID objektu pro instanční objekt, který se má přidat do aplikace. Musí být také zadáno ID tenanta. Pokud je zadaný e-mail, bude ignorován a uživatel nebude instančním uživatelem, ale standardním uživatelem "e-mailu".

--org-id --organization-id

ID organizace pro přiřazení role uživatele. K dispozici pouze pro api-version == 1.1-preview.

--tenant-id --tnid

ID tenanta pro instanční objekt, který se má přidat do aplikace. Musí být také zadáno ID objektu. Pokud je zadaný e-mail, bude ignorován a uživatel nebude instančním uživatelem, ale standardním uživatelem "e-mailu".

--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central user delete

Odstraňte uživatele z aplikace.

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

Příklady

Odstranění uživatele

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

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--assignee --user-id

ID přidružené k uživateli.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central user list

Získejte seznam uživatelů pro aplikaci IoT Central.

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

Příklady

Seznam uživatelů

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

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central user show

Získejte podrobnosti o uživateli podle ID.

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

Příklady

Získání podrobností o uživateli

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

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--assignee --user-id

ID přidružené k uživateli.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central user update

Aktualizujte role pro uživatele v aplikaci.

Aktualizujte uživatele pomocí různých rolí. Aktualizace id tenanta nebo objectId pro uživatele instančního objektu není povolená. Aktualizace e-mailové adresy pro e-mailového uživatele není povolená.

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]

Příklady

Aktualizujte role uživatele e-mailem nebo instančním objektem v aplikaci.

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

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--assignee --user-id

ID přidružené k uživateli.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--email

E-mailová adresa uživatele, který se má přidat do aplikace Pokud je tento parametr zadán, budou parametry instančního objektu (tenant_id a object_id) ignorovány.

--object-id --oid

ID objektu pro instanční objekt, který se má přidat do aplikace. Musí být také zadáno ID tenanta. Pokud je zadaný e-mail, bude ignorován a uživatel nebude instančním uživatelem, ale standardním uživatelem "e-mailu".

--roles

Čárkami oddělený seznam rolí, které budou přidruženy k tomuto uživateli. Můžete zadat jednu z předdefinovaných rolí nebo zadat ID role vlastní role. Další informace najdete na adrese https://aka.ms/iotcentral-customrolesdocs. Organizace je možné při spuštění s rozhraním API verze == 1.1-Preview zadat společně s rolemi. Například "organization_id\role".

--tenant-id --tnid

ID tenanta pro instanční objekt, který se má přidat do aplikace. Musí být také zadáno ID objektu. Pokud je zadaný e-mail, bude ignorován a uživatel nebude instančním uživatelem, ale standardním uživatelem "e-mailu".

--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.