Partilhar via


az iot du update init

Nota

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

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

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

Comandos

Name Description Tipo Status
az iot du update init v5

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

Extensão Pré-visualizar

az iot du update init v5

Pré-visualizar

O grupo de comandos 'iot du update init' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

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

Este comando suporta todos os atributos do manifesto de importação v5. Note que há sensibilidade posicional entre --step e --file, bem como --file e --related-file. Analise exemplos e descrições de parâmetros para obter detalhes sobre como utilizar totalmente a operação.

Leia mais sobre como usar aspas e caracteres de escape em diferentes shells aqui: https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Exemplos

Inicialize um manifesto mínimo de importação de conteúdo. Inline json otimizado para 'bash'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Inicialize um manifesto mínimo de importação de conteúdo. Json em linha otimizado para 'powershell'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Inicialize um manifesto mínimo de importação de conteúdo. Inline json otimizado para 'cmd'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Inicialize um manifesto mínimo de importação de conteúdo. Use a entrada de arquivo para json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Inicialize uma atualização folha não implantável para ser referenciada em uma atualização empacotada. Inline json otimizado para 'bash'.

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Inicialize uma atualização empacotada fazendo referência a uma atualização folha, bem como definindo etapas independentes. Exemplo otimizado para 'bash' usando a continuação do comando para delinear segmentos de manifesto de importação.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Parâmetros Obrigatórios

--compat

Pares chave=valor separados por espaço correspondentes às propriedades de um dispositivo com o qual esta atualização é compatível. Normalmente usado para definir propriedades como fabricante e modelo. --compat pode ser usado 1 ou mais vezes.

--step

Pares key=value separados por espaço correspondentes às propriedades do elemento 'instructions.steps'. O cliente determinará se uma etapa é uma etapa embutida ou de referência com base nos pares de valores de chave fornecidos. Se a etapa embutida ou de referência puder ser satisfeita, a etapa de referência será priorizada. O uso de --file será associado à entrada inline --step mais próxima, derivando o valor para 'files'. As seguintes teclas de etapa de referência são suportadas: updateId.provider, updateId.nameupdateId.version e description. As seguintes teclas de etapa embutidas são suportadas: handler (ex: 'microsoft/script:1' ou 'microsoft/swupdate:1' ou 'microsoft/apt:1'), properties (objeto json in-line que o agente passará para o manipulador) e description. --step pode ser usado 1 ou mais vezes.

--update-name

O nome da atualização como um componente de updateId.

--update-provider

O provedor de atualização como um componente de updateId.

--update-version

A versão de atualização como um componente de updateId.

Parâmetros Opcionais

--description

Descrição do manifesto de importação.

--file

Pares key=value separados por espaço correspondentes às propriedades do elemento 'files'. Uma entrada --file pode incluir as entradas de arquivo --related-file mais próximas, se fornecidas. As seguintes chaves são suportadas: path [required] local file path to update file, downloadHandler (ex: 'microsoft/delta:1') handler for using related files to download payload file, properties (in-line json object the agent will pass to the handler). --file pode ser usado 1 ou mais vezes.

--is-deployable

Indica se a atualização pode ser implantada de forma independente.

Valores aceites: false, true
--no-validation

Desabilita a validação do esquema json do lado do cliente do conteúdo do manifesto de importação.

Valores aceites: false, true
--related-file

Pares key=value separados por espaço correspondentes às propriedades do elemento 'files[*].relatedFiles'. Uma entrada --related-file será associada à entrada --file mais próxima, se existir. As seguintes chaves são suportadas: path [required] caminho do arquivo local para o arquivo de atualização relacionado, properties (objeto json in-line passado para o manipulador de download). --related-file pode ser usado 1 ou mais vezes.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.