Importazione di aggiornamenti in Aggiornamento dispositivi per hub IoT: schema e altre informazioni

Se si vuole importare un aggiornamento in Aggiornamento dispositivi per hub IoT, assicurarsi di aver esaminato prima i concetti e la guida pratica. Se si è interessati ai dettagli dello schema del manifesto di importazione o alle informazioni sulle autorizzazioni API, vedere di seguito.

Lo schema JSON del manifesto di importazione è ospitato in SchemaStore.org.

Schema

Non sono consentite proprietà aggiuntive.

oggetto updateId

L'oggetto updateID è un identificatore univoco per ogni aggiornamento.

Non sono consentite proprietà aggiuntive.

Ad esempio:

{
  "updateId": {
    "provider": "Contoso",
    "name": "Toaster",
    "version": "1.0"
  }
}

oggetto compatibilità

L'oggetto compatibilità descrive le proprietà di un dispositivo con cui questo aggiornamento è compatibile.

• Tipo: object
• Proprietà minime: 1
• Proprietà massime:5

Ogni proprietà è una coppia nome-valore di tipo string.

• Lunghezza minima nome proprietà: 1
• Lunghezza massima nome proprietà: 32
• Lunghezza minima valore proprietà: 1
• Lunghezza massima valore proprietà: 64

Lo stesso set esatto di proprietà di compatibilità non può essere usato con più provider di aggiornamento e combinazione di nomi.

Ad esempio:

{
  "compatibility": [
    {
      "deviceManufacturer": "Contoso",
      "deviceModel": "Toaster"
    }
  ]
}

oggetto instructions

L'oggetto instructions fornisce le istruzioni di installazione degli aggiornamenti. L'oggetto instructions contiene un elenco di passaggi da eseguire. I passaggi possono essere codice da eseguire o un puntatore a un altro aggiornamento.

Non sono consentite proprietà aggiuntive.

Ad esempio:

{
  "instructions": {
    "steps": [
      {
        "type": "inline",
        ...
      },
      {
        "type": "reference",
        ...
      }
    ]
  }
}

oggetto inlineStep

Un oggetto passaggio inline è un passaggio dell'istruzione di installazione che esegue l'esecuzione del codice.

Non sono consentite proprietà aggiuntive.

Ad esempio:

{
  "steps": [
    {
      "description": "pre-install script",
      "handler": "microsoft/script:1",
      "handlerProperties": {
        "arguments": "--pre-install"
      },
      "files": [
        "configure.sh"
      ]
    }
  ]
}

oggetto referenceStep

Un oggetto passaggio di riferimento è un passaggio dell'istruzione di installazione che installa un altro aggiornamento.

Non sono consentite proprietà aggiuntive.

Ad esempio:

{
  "steps": [
    {
      "type": "reference",
      "updateId": {
        "provider": "Contoso",
        "name": "Toaster.HeatingElement",
        "version": "1.0"
      }
    }
  ]
}

oggetto file

Un oggetto file è un file di payload di aggiornamento, ad esempio binario, firmware, script e così via. Ogni oggetto file deve essere univoco all'interno di un aggiornamento.

Non sono consentite proprietà aggiuntive.

Ad esempio:

{
  "files": [
    {
      "filename": "configure.sh",
      "sizeInBytes": 7558,
      "hashes": {...}
    }
  ]
}

oggetto fileHashes

Hash di file con codifica Base64 con il nome dell'algoritmo come chiave. È necessario specificare almeno l'algoritmo SHA-256 e altri algoritmi possono essere specificati se supportati dall'agente. Per un esempio di come calcolare correttamente l'hash, vedere la funzione Get-AduFileHashes nello script AduUpdate.psm1.

Sono consentite proprietà aggiuntive.

Ad esempio:

{
  "hashes": {
    "sha256": "/CD7Sn6fiknWa3NgcFjGlJ+ccA81s1QAXX4oo5GHiFA="
  }
}

Passaggi successivi

Altre informazioni sui concetti relativi all'importazione.

Se si è pronti, provare la guida alle procedure di importazione, che illustra in dettaglio il processo di importazione.