Compartilhar via

az iot du update

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 update. Saiba mais sobre extensões.

Gerenciamento de atualização de atualização de dispositivo.

Comandos

Nome Description Tipo Status
az iot du update calculate-hash

Calcule a representação com hash base64 de um arquivo.

 Extension GA
az iot du update delete

Exclua uma versão de atualização específica.

 Extension GA
az iot du update file

Atualizar operações de arquivo.

 Extension GA
az iot du update file list

Liste as IDs do arquivo de atualização em relação ao provedor de atualização, nome e versão.

 Extension GA
az iot du update file show

Mostre os detalhes de um arquivo de atualização específico em relação ao provedor de atualização, nome e versão.

 Extension GA
az iot du update import

Importe uma nova versão de atualização para a instância de Atualização de Dispositivo.

 Extension GA
az iot du update init

Utilitário para inicialização do manifesto de importação.

 Extension Preview
az iot du update init v5

Inicialize um manifesto de importação v5 com o estado desejado.

 Extension Preview
az iot du update list

Liste as atualizações que foram importadas para a instância de Atualização de dispositivo.

 Extension GA
az iot du update show

Mostrar uma versão de atualização específica.

 Extension GA
az iot du update stage

Prepare uma atualização para importação para uma instância de destino.

 Extension Preview

az iot du update calculate-hash

Calcule a representação com hash base64 de um arquivo.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Exemplos

Calcule a representação base64 de um resumo sha256 para um arquivo de atualização de destino.

az iot du update calculate-hash --file-path /path/to/file

Calcule a representação base64 de um resumo sha256 para vários arquivos de atualização de destino.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Parâmetros Exigidos

--file-path -f

Caminho local para o arquivo de destino para cálculo de hash. --file-path pode ser usado 1 ou mais vezes.

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.

--hash-algo

Algoritmo criptográfico a ser usado para hash.

Propriedade Valor
Valor padrão: sha256
Valores aceitos: sha256
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 update delete

Exclua uma versão de atualização específica.

az iot du update delete --account
                        --instance
                        --un --update-name
                        --up --update-provider
                        --update-version --uv
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Exemplos

Exclua uma atualização de destino em relação ao provedor, ao nome e à versão de atualização.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {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
--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.

--up --update-provider

O provedor de atualização.

--update-version --uv

A versão de atualização.

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.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--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 update import

Importe uma nova versão de atualização para a instância de Atualização de Dispositivo.

Esse comando suporta o --defer recurso. Quando usado, o comando armazenará o conteúdo do objeto que deve ser enviado ao Azure em um cache local. O próximo uso desse comando sem --defer combinará a nova carga de solicitação com os objetos armazenados em cache enviando-os juntos.

Após o sucesso, a entrada de cache local correspondente será limpa. Se ocorrer uma falha, o conteúdo armazenado em cache não será removido. Use az cache comandos para gerenciar entradas de cache local de forma independente.

O suporte a adiamento destina-se principalmente a atualizações com várias etapas de referência, de modo que as atualizações pai e filho possam ser enviadas juntas.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Exemplos

Importe uma atualização com dois arquivos relacionados e nenhuma etapa de referência, fornecendo explicitamente o valor de hash do manifesto e o tamanho do manifesto em bytes.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importe uma atualização com dois arquivos relacionados e nenhuma etapa de referência, permitindo que a CLI calcule o valor e o tamanho do hash do manifesto de importação em bytes.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importe uma atualização pai com duas etapas de referência de atualização filho, em que todos os três manifestos de importação têm um arquivo relacionado. Permitir que a CLI calcule o valor e o tamanho do hash em bytes para todos. Essa operação dependerá da funcionalidade '--defer'.

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

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
--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
--url

Local roteável do qual o manifesto de importação pode ser baixado pela Atualização de Dispositivo para Hub IoT. Normalmente, essa é uma URL de blob protegida por SAS somente leitura com uma expiração definida como pelo menos 3 horas.

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.

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use comandos az cache para exibir/limpar.

--file

Pares key=value separados por espaço correspondentes para importar propriedades de arquivo de metadados de manifesto. As chaves necessárias incluem nome de arquivo e url. --file pode ser usado 1 ou mais vezes.

--friendly-name

Nome amigável associado à definição de atualização.

--hashes

Pares key=value separados por espaço em que a chave é o algoritmo de hash usado e o valor é o hash do arquivo de manifesto de importação codificado em base64. Pelo menos uma entrada sha256 é necessária. Se não for fornecido, ele será calculado a partir da URL fornecida.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--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
--size

Tamanho do arquivo em número de bytes. Se não for fornecido, ele será calculado a partir da URL fornecida.

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 update list

Liste as atualizações que foram importadas para a instância de Atualização de dispositivo.

Ao listar provedores de atualização, somente o sinalizador --by-provider precisa ser fornecido, além dos argumentos de pesquisa de instância comuns. Ao listar nomes de atualização, o provedor de atualização deve ser fornecido. Ao listar versões de atualização, o provedor de atualização e o nome da atualização devem ser fornecidos.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un --update-name]
                      [--up --update-provider]

Exemplos

Listar todas as atualizações.

az iot du update list -n {account_name} -i {instance_name}

Lista todas as atualizações que satisfazem um critério de pesquisa de texto livre, nesse caso, o provedor de atualização da Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Lista todas as atualizações que satisfazem um filtro odata, nesse caso, filtrando atualizações não implantáveis.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Listar todos os provedores de atualização.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Listar todos os nomes de atualização por provedor de atualização.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Liste todas as versões de atualização por provedor de atualização e nome de atualização.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

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

--by-provider

O sinalizador que indica o conjunto de resultados deve ser restrito aos provedores de atualização.

Propriedade Valor
Valores aceitos: false, true
--filter

Restringe o conjunto de atualizações retornadas por valores de propriedade. Com suporte ao listar atualizações sem restrições ou ao listar por versão.

Propriedade Valor
Grupo de parâmetros: Filter 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
--search

Solicite atualizações que correspondam a uma expressão de pesquisa de texto livre. Com suporte ao listar atualizações sem restrições.

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

O nome da atualização.

--up --update-provider

O provedor de atualização.

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 update show

Mostrar uma versão de atualização específica.

az iot du update show --account
                      --instance
                      --un --update-name
                      --up --update-provider
                      --update-version --uv
                      [--resource-group]

Exemplos

Mostrar uma atualização específica em relação ao provedor, ao nome e à versão de atualização.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {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
--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.

--up --update-provider

O provedor de atualização.

--update-version --uv

A versão de atualização.

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 update stage

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Prepare uma atualização para importação para uma instância de destino.

A preparação de uma atualização refere-se à aceleração das etapas de pré-requisito de importação de uma atualização para uma instância de destino. Para um determinado manifesto de importação, o processo determinará os arquivos relevantes, os enviará por push para um contêiner de armazenamento desejado, gerará URIs SAS e abrangerá outras etapas de preparação para uma importação bem-sucedida.

Este comando depende de uma organização baseada em convenção de arquivos de atualização. Espera-se que todos os arquivos de atualização de um manifesto de destino estejam no mesmo diretório em que o manifesto de importação reside.

O acesso baseado em chave é usado para carregar artefatos de blob e gerar URIs SAS de 3 horas de duração com acesso de leitura.

Se --then-import o sinalizador for fornecido, o comando importará a atualização em etapas. Caso contrário, o resultado dessa operação é um comando de importação a ser executado para obter o mesmo resultado posteriormente.

Esse comando limpará e atualizará qualquer entrada de cache local para a instância de destino.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Exemplos

Preparar uma atualização autônoma. Espera-se que os arquivos de atualização residam no mesmo diretório que o manifesto. O comando de importação resultante pode ser executado posteriormente para iniciar a importação da atualização em etapas antes da expiração do token SAS.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Preparar uma atualização autônoma. Após o preparo, importe a atualização para a instância usando um nome amigável desejado.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Preparar uma atualização de várias referências. Os arquivos de atualização serão carregados em um contêiner de blob de armazenamento que reside em uma assinatura diferente para a conta de atualização.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Preparar uma atualização de várias referências, substituindo blobs existentes se eles existirem. Após o preparo, importe a atualização para a instância.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

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
--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
--manifest-path

Caminho do arquivo local para o manifesto de importação que deve ser preparado. Pode ser usado 1 ou mais vezes.

--storage-account

Nome da conta de armazenamento desejada para preparar artefatos de manifesto de importação.

Propriedade Valor
Grupo de parâmetros: Storage Arguments
--storage-container

Nome do contêiner de armazenamento desejado para preparar artefatos de manifesto de importação.

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

--friendly-name

Nome amigável associado à definição de atualização.

--overwrite

Sinalizador que indica se os blobs existentes devem ser substituídos se houver um conflito.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--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
--storage-subscription

Assinatura de conta de armazenamento desejada para preparar artefatos de manifesto de importação. Aplicável quando as contas de atualização de dispositivo e armazenamento estão em assinaturas diferentes.

Propriedade Valor
Grupo de parâmetros: Storage Arguments
--then-import

Sinalizador indicando se a atualização deve ser importada após o preparo.

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