Compartilhar via

az iot du device deployment

  • Referência

Observação

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot du device deployment . Saiba mais sobre extensões.

Gerenciamento de implantação de dispositivos.

As implantações aplicarão uma atualização compatível desejada em um grupo de dispositivos de destino distribuindo a atualização entre classes de dispositivo dentro do grupo. A política de reversão iniciada na nuvem pode ser configurada opcionalmente.

Comandos

Nome Description Tipo Status
az iot du device deployment cancel

Cancelar a implantação de um subgrupo de classe de dispositivo.

 Extensão GA
az iot du device deployment create

Crie uma implantação para um grupo de dispositivos. A implantação será multicast em cada subgrupo de classe de dispositivo dentro do grupo de destino.

 Extensão GA
az iot du device deployment delete

Exclua uma implantação por grupo de dispositivos ou subgrupo de classe de dispositivo.

 Extensão GA
az iot du device deployment list

Listar implantações para um grupo de dispositivos ou subgrupo de classe de dispositivo.

 Extensão GA
az iot du device deployment list-devices

Listar dispositivos em uma implantação de subgrupo de classe de dispositivo junto com seu estado. Útil para obter uma lista de dispositivos com falha.

 Extensão GA
az iot du device deployment retry

Repita a implantação de um subgrupo de classe de dispositivo.

 Extensão GA
az iot du device deployment show

Mostrar uma implantação para um grupo de dispositivos ou subgrupo de classe de dispositivo, incluindo o status que detalha um detalhamento de quantos dispositivos na implantação estão em andamento, concluídos ou com falha.

 Extensão GA

az iot du device deployment cancel

Cancelar a implantação de um subgrupo de classe de dispositivo.

az iot du device deployment cancel --account
                                   --cid
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--resource-group]

Exemplos

Cancele a implantação do subgrupo de classe de dispositivo de destino.

az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

--deployment-id --did

A ID de implantação fornecida pelo chamador. Isso não pode ter mais de 73 caracteres, deve ser todo minúsculo e não pode conter '&', '^', '[', ']', '{', '}', '|', '<', '', barra> invertida, barra invertida ou aspas duplas.

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device deployment create

Crie uma implantação para um grupo de dispositivos. A implantação será multicast em cada subgrupo de classe de dispositivo dentro do grupo de destino.

az iot du device deployment create --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   --un
                                   --up
                                   --update-version
                                   [--failed-count]
                                   [--failed-percentage]
                                   [--rbun]
                                   [--rbup]
                                   [--rbuv]
                                   [--resource-group]
                                   [--start-time]

Exemplos

Crie uma implantação de grupo de dispositivos agendada para iniciar imediatamente (com relação ao horário UTC).

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

Crie uma implantação de grupo de dispositivos agendada para iniciar em uma data/hora compatível com iso-8601 desejada.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

Crie uma implantação de grupo de dispositivos agendada para começar imediatamente com uma política de reversão iniciada na nuvem definida. A reversão na nuvem é iniciada quando as metas de contagem com falha ou porcentagem com falha são atendidas.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--deployment-id --did

A ID de implantação fornecida pelo chamador. Isso não pode ter mais de 73 caracteres, deve ser todo minúsculo e não pode conter '&', '^', '[', ']', '{', '}', '|', '<', '', barra> invertida, barra invertida ou aspas duplas.

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

--un --update-name

O nome da atualização.

--up --update-provider

O provedor de atualização.

--update-version --uv

A versão de atualização.

Parâmetros Opcionais

--failed-count --fc

Inteiro que representa o número de dispositivos com falha em uma implantação antes que ocorra uma reversão iniciada na nuvem. Obrigatório ao definir a política de reversão.

--failed-percentage --fp

Inteiro que representa a porcentagem de dispositivos com falha em uma implantação antes que ocorra uma reversão iniciada na nuvem. Obrigatório ao definir a política de reversão.

--rbun --rollback-update-name

O nome da atualização de reversão.

--rbup --rollback-update-provider

O provedor de atualização de reversão.

--rbuv --rollback-update-version

A versão de atualização de reversão.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

--start-time

A hora de início da implantação compatível com iso-8601. Se nenhum valor for fornecido, o valor correspondente para UTC 'now' será usado.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device deployment delete

Exclua uma implantação por grupo de dispositivos ou subgrupo de classe de dispositivo.

az iot du device deployment delete --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--cid]
                                   [--resource-group]
                                   [--yes {false, true}]

Exemplos

Exclua a implantação do grupo de dispositivos de destino.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}

Exclua a implantação do subgrupo de classe de dispositivo de destino.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--deployment-id --did

A ID de implantação fornecida pelo chamador. Isso não pode ter mais de 73 caracteres, deve ser todo minúsculo e não pode conter '&', '^', '[', ']', '{', '}', '|', '<', '', barra> invertida, barra invertida ou aspas duplas.

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

--yes -y

Ignorar prompts do usuário. Indica aceitação da ação. Usado principalmente para cenários de automação. Padrão: falso.

Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device deployment list

Listar implantações para um grupo de dispositivos ou subgrupo de classe de dispositivo.

az iot du device deployment list --account
                                 --gid
                                 --instance
                                 [--cid]
                                 [--order-by]
                                 [--resource-group]

Exemplos

Listar implantações para um grupo de dispositivos.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}

Listar implantações para um grupo de dispositivos ordenando resultados por startDateTime descendente.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

Listar implantações para um subgrupo de classe de dispositivo.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

--order-by

Ordena que o conjunto de implantações retornado. Você pode encomendar por startDateTime [desc/asc].

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device deployment list-devices

Listar dispositivos em uma implantação de subgrupo de classe de dispositivo junto com seu estado. Útil para obter uma lista de dispositivos com falha.

az iot du device deployment list-devices --account
                                         --cid
                                         --deployment-id
                                         --gid
                                         --instance
                                         [--filter]
                                         [--resource-group]

Exemplos

Listar dispositivos em uma implantação de subgrupo de classe de dispositivo.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Listar dispositivos em uma implantação de subgrupo de classe de dispositivo filtrando por deviceId e deviceState.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

--deployment-id --did

A ID de implantação fornecida pelo chamador. Isso não pode ter mais de 73 caracteres, deve ser todo minúsculo e não pode conter '&', '^', '[', ']', '{', '}', '|', '<', '', barra> invertida, barra invertida ou aspas duplas.

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--filter

Restringe o conjunto de estados de dispositivo de implantação retornados. Você pode filtrar em deviceId e moduleId e/ou deviceState.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device deployment retry

Repita a implantação de um subgrupo de classe de dispositivo.

az iot du device deployment retry --account
                                  --cid
                                  --deployment-id
                                  --gid
                                  --instance
                                  [--resource-group]

Exemplos

Repita a implantação do subgrupo de classe de dispositivo de destino.

az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

--deployment-id --did

A ID de implantação fornecida pelo chamador. Isso não pode ter mais de 73 caracteres, deve ser todo minúsculo e não pode conter '&', '^', '[', ']', '{', '}', '|', '<', '', barra> invertida, barra invertida ou aspas duplas.

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device deployment show

Mostrar uma implantação para um grupo de dispositivos ou subgrupo de classe de dispositivo, incluindo o status que detalha um detalhamento de quantos dispositivos na implantação estão em andamento, concluídos ou com falha.

az iot du device deployment show --account
                                 --deployment-id
                                 --gid
                                 --instance
                                 [--cid]
                                 [--resource-group]
                                 [--status {false, true}]

Exemplos

Mostrar uma implantação para um grupo de dispositivos.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}

Mostrar o status de uma implantação de grupo de dispositivos.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status

Mostrar uma implantação para um subgrupo de classe de dispositivo.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Mostrar o status de uma implantação de subgrupo de classe de dispositivo.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--deployment-id --did

A ID de implantação fornecida pelo chamador. Isso não pode ter mais de 73 caracteres, deve ser todo minúsculo e não pode conter '&', '^', '[', ']', '{', '}', '|', '<', '', barra> invertida, barra invertida ou aspas duplas.

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

--status

Obtém o status de uma implantação, incluindo um detalhamento de quantos dispositivos na implantação estão em andamento, concluídos ou com falha.

Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.