Compartilhar via


az iot du device deployment

Note

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará 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 dispositivos 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

Cancele uma implantação de subgrupo de classe de dispositivo.

Extension 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.

Extension GA
az iot du device deployment delete

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

Extension GA
az iot du device deployment list

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

Extension GA
az iot du device deployment list-devices

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

Extension GA
az iot du device deployment retry

Repita uma implantação de subgrupo de classe de dispositivo.

Extension GA
az iot du device deployment show

Mostre 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.

Extension GA

az iot du device deployment cancel

Cancele uma implantação de subgrupo de classe de dispositivo.

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

Exemplos

Cancele a implantação de subgrupo da 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--cid --class-id

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

--deployment-id --did

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

--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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 --did
                                   --gid --group-id
                                   --instance
                                   --un --update-name
                                   --up --update-provider
                                   --update-version --uv
                                   [--failed-count --fc]
                                   [--failed-percentage --fp]
                                   [--rbun --rollback-update-name]
                                   [--rbup --rollback-update-provider]
                                   [--rbuv --rollback-update-version]
                                   [--resource-group]
                                   [--start-time]

Exemplos

Crie uma implantação de grupo de dispositivos agendada para iniciar imediatamente (em relação à hora 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 um datetime compatível com iso-8601 desejado.

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 iniciar imediatamente com uma política de reversão iniciada pela nuvem definida. A reversão da nuvem é iniciada quando a contagem com falha ou as metas percentuais 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--deployment-id --did

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

--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--un --update-name

O nome da atualização.

Propriedade Valor
Grupo de parâmetros: Update Id Arguments
--up --update-provider

O provedor de atualização.

Propriedade Valor
Grupo de parâmetros: Update Id Arguments
--update-version --uv

A versão de atualização.

Propriedade Valor
Grupo de parâmetros: Update Id Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--failed-count --fc

Inteiro que representa o número de dispositivos com falha em uma implantação antes de ocorrer uma reversão interna na nuvem. Necessário ao definir a política de reversão.

Propriedade Valor
Grupo de parâmetros: Update Rollback Policy Arguments
--failed-percentage --fp

Inteiro que representa a porcentagem de dispositivos com falha em uma implantação antes de ocorrer uma reversão interna na nuvem. Necessário ao definir a política de reversão.

Propriedade Valor
Grupo de parâmetros: Update Rollback Policy Arguments
--rbun --rollback-update-name

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

Propriedade Valor
Grupo de parâmetros: Update Rollback Policy Arguments
--rbup --rollback-update-provider

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

Propriedade Valor
Grupo de parâmetros: Update Rollback Policy Arguments
--rbuv --rollback-update-version

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

Propriedade Valor
Grupo de parâmetros: Update Rollback Policy Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--start-time

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

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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 --did
                                   --gid --group-id
                                   --instance
                                   [--cid --class-id]
                                   [--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 de subgrupo da 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--deployment-id --did

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

--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cid --class-id

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

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--yes -y

Ignore as solicitações do usuário. Indica a aceitação da ação. Usado principalmente para cenários de automação. Padrão: false.

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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 --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--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 decrescente.

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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cid --class-id

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

--order-by

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

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot du device deployment list-devices

Liste os 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 --class-id
                                         --deployment-id --did
                                         --gid --group-id
                                         --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 filtragem de implantação de subgrupo de classe de dispositivo 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--cid --class-id

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

--deployment-id --did

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

--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--filter

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

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot du device deployment retry

Repita uma implantação de subgrupo de classe de dispositivo.

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

Exemplos

Tente novamente a implantação de 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--cid --class-id

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

--deployment-id --did

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

--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot du device deployment show

Mostre 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 --did
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--deployment-id --did

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

--gid --group-id

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

--instance -i

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cid --class-id

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

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Account Identifier Arguments
--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.

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False