az iot adr ns su instance

Note

Esta referencia forma parte de la extensión azure-iot para el CLI de Azure (versión 2.73.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot adr ns su instance . Obtenga más información sobre las extensiones.

El grupo de comandos "iot adr ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administre la instancia de actualización que activa las actualizaciones de software.

Las instancias de actualización son Microsoft de nivel superior. Recursos de DeviceUpdate. Se agrupan aquí para la detectabilidad del Registro de dispositivos, pero no son elementos secundarios del espacio de nombres.

Comandos

Nombre Description Tipo Estado
az iot adr ns su instance check-name

Compruebe si hay disponible un nombre de instancia de actualización.

Extension Preview
az iot adr ns su instance create

Cree una instancia de actualización.

Extension Preview
az iot adr ns su instance delete

Elimine una instancia de actualización.

Extension Preview
az iot adr ns su instance list

Enumerar instancias de actualización.

Extension Preview
az iot adr ns su instance show

Mostrar una instancia de actualización.

Extension Preview
az iot adr ns su instance update

Actualice las etiquetas o la identidad administrada de una instancia de actualización.

Extension Preview
az iot adr ns su instance wait

Espere a que se actualice la condición de instancia.

Extension Preview

az iot adr ns su instance check-name

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Compruebe si hay disponible un nombre de instancia de actualización.

az iot adr ns su instance check-name --name
                                     [--acquire-policy-token]
                                     [--change-reference]

Ejemplos

Comprobación de un nombre

az iot adr ns su instance check-name -n myUpdateInstance

Parámetros requeridos

--name -n

Nombre de la instancia de actualización.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot adr ns su instance create

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree una instancia de actualización.

Crea un Microsoft. Recurso DeviceUpdate/updateInstances. Los argumentos de identidad administrada se pueden combinar y describir el estado de identidad deseado completo cuando se proporciona. Volver a ejecutar la creación sin ninguna de las opciones de identidad conserva la configuración de SAMI/UAMI de una instancia existente, las etiquetas y el estado administrado por el servicio.

az iot adr ns su instance create --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--location]
                                 [--mi-sa --system-assigned-mi {false, true}]
                                 [--mi-ua --user-assigned-mi]
                                 [--no-wait]
                                 [--tags]

Ejemplos

Creación de una instancia con una identidad asignada por el sistema

az iot adr ns su instance create -n myUpdateInstance -g myResourceGroup --location eastus2 --system-assigned-mi

Creación de una instancia con identidades asignadas por el sistema y el usuario

az iot adr ns su instance create -n myUpdateInstance -g myResourceGroup \
  --system-assigned-mi --user-assigned-mi /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity>

Reemplazar una identidad de instancia existente por una configuración solo asignada por el usuario

az iot adr ns su instance create -n myUpdateInstance -g myResourceGroup \
  --user-assigned-mi /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity>

Parámetros requeridos

--name -n

Nombre de la instancia de actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--mi-sa --system-assigned-mi

Incluya o quite la identidad administrada asignada por el sistema. Al crear o actualizar, al omitir todas las opciones de identidad administrada se conserva la identidad existente.

Propiedad Valor
Valores aceptados: false, true
--mi-ua --user-assigned-mi

Complete el conjunto deseado de identificadores de recursos de identidad administrada asignados por el usuario. Al crear o actualizar, al omitir todas las opciones de identidad administrada se conserva la identidad existente.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot adr ns su instance delete

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine una instancia de actualización.

az iot adr ns su instance delete --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--no-wait]
                                 [--yes {false, true}]

Ejemplos

Eliminar sin preguntar

az iot adr ns su instance delete -n myUpdateInstance -g myResourceGroup --yes

Parámetros requeridos

--name -n

Nombre de la instancia de actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Valor predeterminado: false.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot adr ns su instance list

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumerar instancias de actualización.

az iot adr ns su instance list [--resource-group]

Ejemplos

Enumeración de instancias en un grupo de recursos

az iot adr ns su instance list -g myResourceGroup

Enumeración de instancias de la suscripción

az iot adr ns su instance list

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot adr ns su instance show

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar una instancia de actualización.

az iot adr ns su instance show --name
                               --resource-group

Ejemplos

Mostrar una instancia

az iot adr ns su instance show -n myUpdateInstance -g myResourceGroup

Parámetros requeridos

--name -n

Nombre de la instancia de actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot adr ns su instance update

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice las etiquetas o la identidad administrada de una instancia de actualización.

Las opciones de identidad describen el estado de identidad deseado completo cuando se proporciona: --system-assigned-mi controla SAMI y --user-assigned-mi proporciona el conjunto de UAMI. Omita ambas opciones de identidad para dejar la identidad existente sin cambios.

az iot adr ns su instance update --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--mi-sa --system-assigned-mi {false, true}]
                                 [--mi-ua --user-assigned-mi]
                                 [--no-wait]
                                 [--tags]

Ejemplos

Actualizar etiquetas

az iot adr ns su instance update -n myUpdateInstance -g myResourceGroup --tags environment=test

Establecer la identidad en asignada por el sistema

az iot adr ns su instance update -n myUpdateInstance -g myResourceGroup --system-assigned-mi

Parámetros requeridos

--name -n

Nombre de la instancia de actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--mi-sa --system-assigned-mi

Incluya o quite la identidad administrada asignada por el sistema. Al crear o actualizar, al omitir todas las opciones de identidad administrada se conserva la identidad existente.

Propiedad Valor
Valores aceptados: false, true
--mi-ua --user-assigned-mi

Complete el conjunto deseado de identificadores de recursos de identidad administrada asignados por el usuario. Al crear o actualizar, al omitir todas las opciones de identidad administrada se conserva la identidad existente.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot adr ns su instance wait

Vista previa

El grupo de comandos "iot adr ns su instance" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Espere a que se actualice la condición de instancia.

Sin un predicado de espera explícito, espera a provisioningState Succeeded.

az iot adr ns su instance wait --name
                               --resource-group
                               [--acquire-policy-token]
                               [--change-reference]
                               [--created]
                               [--custom]
                               [--deleted]
                               [--exists]
                               [--interval]
                               [--timeout]
                               [--updated]

Ejemplos

Espere hasta que el aprovisionamiento se realice correctamente

az iot adr ns su instance wait -n myUpdateInstance -g myResourceGroup

Parámetros requeridos

--name -n

Nombre de la instancia de actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--created

Espere hasta que provisioningState sea Correcto.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

Espere hasta que una expresión JMESPath personalizada se evalúe como true.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 30
--timeout

Presupuesto de sondeo en segundos, incluida la hora GET. Get en vuelo está limitado por tiempos de espera de transporte y no se puede interrumpir con esta fecha límite de sondeo.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
--updated

Espere hasta que provisioningState sea Correcto.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False