az iot du update init

Versão Prévia

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

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

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

Comandos

Nome	Description	Tipo	Status
az iot du update init v5	Inicialize um manifesto de importação v5 com o estado desejado.	Extension	Preview

az iot du update init v5

Versão Prévia

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

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

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

Leia mais sobre o uso de 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. JSON embutido 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 embutido 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. JSON embutido 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 de folha não implantável a ser referenciada em uma atualização agrupada. JSON embutido 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 agrupada referenciando uma atualização folha, bem como definindo etapas independentes. Exemplo otimizado para 'bash' usando a continuação de 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 Exigidos

--compat

Pares key=value separados por espaço correspondentes às propriedades de um dispositivo com o qual essa 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 uma etapa embutida ou de referência puder ser atendida, a etapa de referência será priorizada. O uso de --file será associado à entrada de etapa --embutida mais próxima, derivando o valor para 'arquivos'. Há suporte para as seguintes chaves de etapa de referência: updateId.provider, updateId.name, updateId.version e description. Há suporte para as seguintes chaves de etapa embutidas: handler (por exemplo: 'microsoft/script:1' ou 'microsoft/swupdate:1' ou 'microsoft/apt:1'), properties (objeto json em linha 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

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.

--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 --related-file mais próximas, se fornecidas. Há suporte para as seguintes chaves: path caminho de arquivo local [necessário] para atualizar o arquivo, downloadHandler (por exemplo: manipulador 'microsoft/delta:1') para utilizar arquivos relacionados para baixar o arquivo de conteúdo, properties (objeto json na linha que o agente passará para o manipulador). --file pode ser usado 1 ou mais vezes.

--is-deployable

Indica se a atualização é implantável de forma independente.

Propriedade	Valor
Valores aceitos:	false, true

--no-validation

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

Propriedade	Valor
Valores aceitos:	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 de arquivo --mais próxima, se existir. Há suporte para as seguintes chaves: path caminho de arquivo local [obrigatório] para o arquivo de atualização relacionado, properties (objeto json em linha passado para o manipulador de download). --related-file can be used 1 or more times.

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

Comentários

Esta página foi útil?