Compartir a través de

az iot ops asset

  • Referencia

Nota:

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

Administración de activos.

Para obtener más información sobre la administración de recursos, consulte aka.ms/asset-overview.

Comandos

Nombre Description Tipo Estado
az iot ops asset create

Cree un recurso.

 Extensión GA
az iot ops asset dataset

Administrar conjuntos de datos en un recurso.

 Extensión GA
az iot ops asset dataset list

Enumerar conjuntos de datos dentro de un recurso.

 Extensión GA
az iot ops asset dataset point

Administrar puntos de datos en un conjunto de datos de recursos.

 Extensión GA
az iot ops asset dataset point add

Agregue un punto de datos a un conjunto de datos de recursos.

 Extensión GA
az iot ops asset dataset point export

Exportar puntos de datos en un conjunto de datos de recursos.

 Extensión GA
az iot ops asset dataset point import

Importe puntos de datos en un conjunto de datos de recursos.

 Extensión GA
az iot ops asset dataset point list

Enumeración de puntos de datos en un conjunto de datos de recursos.

 Extensión GA
az iot ops asset dataset point remove

Quite un punto de datos de un conjunto de datos de recursos.

 Extensión GA
az iot ops asset dataset show

Mostrar un conjunto de datos dentro de un recurso.

 Extensión GA
az iot ops asset delete

Eliminar un recurso.

 Extensión GA
az iot ops asset endpoint

Administrar perfiles de punto de conexión de recursos.

 Extensión GA
az iot ops asset endpoint create

Cree perfiles de punto de conexión de recursos.

 Extensión GA
az iot ops asset endpoint create custom

Cree un perfil de punto de conexión de recurso para un conector personalizado.

 Extensión Obsolescente
az iot ops asset endpoint create onvif

Cree un perfil de punto de conexión de recurso para un conector onvif.

 Extensión Obsolescente
az iot ops asset endpoint create opcua

Cree un perfil de punto de conexión de recurso para un conector OPCUA.

 Extensión GA
az iot ops asset endpoint delete

Elimine un perfil de punto de conexión de recurso.

 Extensión GA
az iot ops asset endpoint query

Consulte resource Graph para ver los perfiles de punto de conexión de recursos.

 Extensión GA
az iot ops asset endpoint show

Mostrar un perfil de punto de conexión de recurso.

 Extensión GA
az iot ops asset endpoint update

Actualice un perfil de punto de conexión de recurso.

 Extensión GA
az iot ops asset event

Administrar eventos en un recurso.

 Extensión GA
az iot ops asset event add

Agregue un evento a un recurso.

 Extensión GA
az iot ops asset event export

Exportar eventos en un recurso.

 Extensión GA
az iot ops asset event import

Importar eventos en un recurso.

 Extensión GA
az iot ops asset event list

Enumerar eventos en un recurso.

 Extensión GA
az iot ops asset event remove

Quite un evento en un recurso.

 Extensión GA
az iot ops asset query

Consulte resource Graph para los recursos.

 Extensión GA
az iot ops asset show

Mostrar un recurso.

 Extensión GA
az iot ops asset update

Actualice un recurso.

 Extensión GA

az iot ops asset create

Cree un recurso.

Para obtener ejemplos de formatos de archivo, consulte aka.ms/aziotops-assets.

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Ejemplos

Cree un recurso mediante la instancia especificada en el mismo grupo de recursos.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

Cree un recurso mediante la instancia especificada en un grupo de recursos diferente, pero en la misma suscripción. Tenga en cuenta que la experiencia de operaciones digitales puede no mostrar el recurso si está en una suscripción diferente de la instancia.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

Cree un recurso deshabilitado mediante un archivo que contenga eventos.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

Cree un recurso con los valores rellenados previamente especificados.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

Parámetros requeridos

--endpoint-profile --ep

Nombre del perfil del punto de conexión de recurso.

--instance

Nombre de instancia al que se va a asociar el recurso creado.

--name -n

Nombre del recurso.

--resource-group -g

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

Parámetros opcionales

--attr --custom-attribute

Pares clave=valor separados por espacios correspondientes a atributos personalizados adicionales para el recurso. Este parámetro se puede usar más de una vez.

--dataset-publish-int --dpi

Intervalo de publicación predeterminado para conjuntos de datos.

Valor predeterminado: 1000
--dataset-queue-size --dqs

Tamaño de cola predeterminado para conjuntos de datos.

Valor predeterminado: 1
--dataset-sample-int --dsi

Intervalo de muestreo predeterminado (en milisegundos) para conjuntos de datos.

Valor predeterminado: 500
--description -d

Descripción.

--disable

Deshabilite un recurso.

Valores aceptados: false, true
Valor predeterminado: False
--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

--eai --external-asset-id

Id. de recurso externo.

--ef --event-file

Ruta de acceso del archivo que contiene los eventos. Se admiten los siguientes tipos de archivo: json, csv, yaml.

--epi --event-publish-int

Intervalo de publicación predeterminado para eventos.

Valor predeterminado: 1000
--eqs --event-queue-size

Tamaño de cola predeterminado para eventos.

Valor predeterminado: 1
--esi --event-sample-int

Intervalo de muestreo predeterminado (en milisegundos) para eventos.

Valor predeterminado: 500
--event

Pares clave=valor separados por espacios correspondientes a las propiedades del evento que se van a crear. Se admiten los siguientes valores de clave: event_notifier (obligatorio), (obligatorio), nameobservability_mode (ninguno o registro), sampling_interval (int), queue_size (int). --event se puede usar 1 o más veces. Revise los ejemplos de ayuda para ver el uso completo de parámetros.

--hardware-revision --hr

Revisión de hardware.

--ig --instance-resource-group

Grupo de recursos de instancia. Si no se proporciona, se usará el grupo de recursos de recursos.

--instance-subscription --is
Obsoleto

El argumento "instance_subscription" está en desuso y se quitará en una versión futura.

Identificador de suscripción de instancia. Si no se proporciona, se usará el identificador de suscripción de recurso.

--location -l

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

--manufacturer

Fabricante.

--manufacturer-uri --mu

URI del fabricante.

--model

Modelo.

--pc --product-code

Código del producto.

--serial-number --sn

Número de serie.

--software-revision --sr

Revisión de software.

--tags

Etiquetas de recursos. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

--topic-path --tp

Ruta de acceso de tema predeterminada.

--topic-retain --tr

Directiva predeterminada de retención de temas.

Valores aceptados: Keep, Never
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset delete

Eliminar un recurso.

az iot ops asset delete --name
                        --resource-group

Ejemplos

Eliminar un recurso.

az iot ops asset delete --name myasset -g myresourcegroup

Parámetros requeridos

--name -n

Nombre del recurso.

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset query

Consulte resource Graph para los recursos.

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {Keep, Never}]

Ejemplos

Consulte los recursos que están deshabilitados dentro de un grupo de recursos determinado.

az iot ops asset query -g myresourcegroup --disabled

Consulte los recursos que tienen el modelo, el fabricante y el número de serie especificados.

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

Parámetros opcionales

--cq --custom-query

Consulta personalizada que se va a usar. Se omitirán todos los demás argumentos de consulta.

--description -d

Descripción.

--disabled

Estado del recurso.

Valores aceptados: false, true
--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

--eai --external-asset-id

Id. de recurso externo.

--endpoint-profile --ep

Nombre del perfil del punto de conexión de recurso.

--hardware-revision --hr

Revisión de hardware.

--ig --instance-resource-group

Grupo de recursos de instancia. Si no se proporciona, se usará el grupo de recursos de recursos.

--instance

Nombre de instancia al que se va a asociar el recurso creado.

--location -l

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

--manufacturer

Fabricante.

--manufacturer-uri --mu

URI del fabricante.

--model

Modelo.

--name -n

Nombre del recurso.

--pc --product-code

Código del producto.

--resource-group -g

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

--serial-number --sn

Número de serie.

--software-revision --sr

Revisión de software.

--topic-path --tp

Ruta de acceso de tema predeterminada.

--topic-retain --tr

Directiva predeterminada de retención de temas.

Valores aceptados: Keep, Never
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset show

Mostrar un recurso.

az iot ops asset show --name
                      --resource-group

Ejemplos

Muestra los detalles de un recurso.

az iot ops asset show --name myasset -g myresourcegroup

Parámetros requeridos

--name -n

Nombre del recurso.

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset update

Actualice un recurso.

Para actualizar los conjuntos de datos y los eventos, use los grupos az iot ops asset dataset de comandos y az iot ops asset event respectivamente.

az iot ops asset update --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Ejemplos

Actualice los valores predeterminados de eventos y conjuntos de datos de un recurso.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

Actualice la descripción de un recurso, el URI de documentación, la revisión de hardware, el código de producto y la revisión de software.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

Actualice el fabricante, el URI del fabricante, el modelo, el número de serie y el atributo personalizado de un recurso.

az iot ops asset update --name myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

Deshabilite un recurso y quite un atributo personalizado denominado "work_site".

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

Parámetros requeridos

--name -n

Nombre del recurso.

--resource-group -g

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

Parámetros opcionales

--attr --custom-attribute

Pares clave=valor separados por espacios correspondientes a atributos personalizados adicionales para el recurso. Este parámetro se puede usar más de una vez. Para quitar un atributo personalizado, establezca el valor del atributo en "".

--dataset-publish-int --dpi

Intervalo de publicación predeterminado para conjuntos de datos.

--dataset-queue-size --dqs

Tamaño de cola predeterminado para conjuntos de datos.

--dataset-sample-int --dsi

Intervalo de muestreo predeterminado (en milisegundos) para conjuntos de datos.

--description -d

Descripción.

--disable

Deshabilite un recurso.

Valores aceptados: false, true
--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

--epi --event-publish-int

Intervalo de publicación predeterminado para eventos.

--eqs --event-queue-size

Tamaño de cola predeterminado para eventos.

--esi --event-sample-int

Intervalo de muestreo predeterminado (en milisegundos) para eventos.

--hardware-revision --hr

Revisión de hardware.

--manufacturer

Fabricante.

--manufacturer-uri --mu

URI del fabricante.

--model

Modelo.

--pc --product-code

Código del producto.

--serial-number --sn

Número de serie.

--software-revision --sr

Revisión de software.

--tags

Etiquetas de recursos. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

--topic-path --tp

Ruta de acceso de tema predeterminada.

--topic-retain --tr

Directiva predeterminada de retención de temas.

Valores aceptados: Keep, Never
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.