az iot ops asset

Note

Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.67.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.	Extension	GA
az iot ops asset dataset	Administrar conjuntos de datos en un recurso.	Extension	GA
az iot ops asset dataset list	Enumerar conjuntos de datos dentro de un recurso.	Extension	GA
az iot ops asset dataset point	Administrar puntos de datos en un conjunto de datos de recursos.	Extension	GA
az iot ops asset dataset point add	Agregue un punto de datos a un conjunto de datos de recursos.	Extension	GA
az iot ops asset dataset point export	Exportar puntos de datos en un conjunto de datos de recursos.	Extension	GA
az iot ops asset dataset point import	Importe puntos de datos en un conjunto de datos de recursos.	Extension	GA
az iot ops asset dataset point list	Enumeración de puntos de datos en un conjunto de datos de recursos.	Extension	GA
az iot ops asset dataset point remove	Quite un punto de datos de un conjunto de datos de recursos.	Extension	GA
az iot ops asset dataset show	Mostrar un conjunto de datos dentro de un recurso.	Extension	GA
az iot ops asset delete	Eliminar un recurso.	Extension	GA
az iot ops asset endpoint	Administrar perfiles de punto de conexión de recursos.	Extension	GA
az iot ops asset endpoint create	Cree perfiles de punto de conexión de recursos.	Extension	GA
az iot ops asset endpoint create opcua	Cree un perfil de punto de conexión de recurso para un conector OPCUA.	Extension	GA
az iot ops asset endpoint delete	Elimine un perfil de punto de conexión de recurso.	Extension	GA
az iot ops asset endpoint query	Consulte resource Graph para ver los perfiles de punto de conexión de recursos.	Extension	GA
az iot ops asset endpoint show	Mostrar un perfil de punto de conexión de recurso.	Extension	GA
az iot ops asset endpoint update	Actualice un perfil de punto de conexión de recurso.	Extension	GA
az iot ops asset event	Administrar eventos en un recurso.	Extension	GA
az iot ops asset event add	Agregue un evento a un recurso.	Extension	GA
az iot ops asset event export	Exportar eventos en un recurso.	Extension	GA
az iot ops asset event import	Importar eventos en un recurso.	Extension	GA
az iot ops asset event list	Enumerar eventos en un recurso.	Extension	GA
az iot ops asset event remove	Quite un evento en un recurso.	Extension	GA
az iot ops asset query	Consulte resource Graph para los recursos.	Extension	GA
az iot ops asset show	Mostrar un recurso.	Extension	GA
az iot ops asset update	Actualice un recurso.	Extension	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 --ep
                        --instance
                        --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--eai --external-asset-id]
                        [--ef --event-file]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--event]
                        [--hardware-revision --hr]
                        [--ig --instance-resource-group]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {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

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.

--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.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--dataset-publish-int --dpi

Intervalo de publicación predeterminado para conjuntos de datos.

Propiedad	Valor
Grupo de parámetros:	Dataset Default Arguments
Valor predeterminado:	1000

--dataset-queue-size --dqs

Tamaño de cola predeterminado para conjuntos de datos.

Propiedad	Valor
Grupo de parámetros:	Dataset Default Arguments
Valor predeterminado:	1

--dataset-sample-int --dsi

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

Propiedad	Valor
Grupo de parámetros:	Dataset Default Arguments
Valor predeterminado:	500

--description -d

Description.

--disable

Deshabilite un recurso.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--eai --external-asset-id

Id. de recurso externo.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--ef --event-file

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

Propiedad	Valor
Grupo de parámetros:	Event Arguments

--epi --event-publish-int

Intervalo de publicación predeterminado para eventos.

Propiedad	Valor
Grupo de parámetros:	Event Default Arguments
Valor predeterminado:	1000

--eqs --event-queue-size

Tamaño de cola predeterminado para eventos.

Propiedad	Valor
Grupo de parámetros:	Event Default Arguments
Valor predeterminado:	1

--esi --event-sample-int

Intervalo de muestreo predeterminado (en milisegundos) para eventos.

Propiedad	Valor
Grupo de parámetros:	Event Default Arguments
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.

Propiedad	Valor
Grupo de parámetros:	Event Arguments

--hardware-revision --hr

Revisión de hardware.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--ig --instance-resource-group

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

--location -l

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

--manufacturer

Manufacturer.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--manufacturer-uri --mu

URI del fabricante.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--model

Model.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--pc --product-code

Código del producto.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--serial-number --sn

Número de serie.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--software-revision --sr

Revisión de software.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--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.

Propiedad	Valor
Grupo de parámetros:	MQTT Topic Default Arguments

--topic-retain --tr

Directiva predeterminada de retención de temas.

Propiedad	Valor
Grupo de parámetros:	MQTT Topic Default Arguments
Valores aceptados:	Keep, Never

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 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 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 ops asset query

Consulte resource Graph para los recursos.

az iot ops asset query [--cq --custom-query]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name --dn]
                       [--documentation-uri --du]
                       [--eai --external-asset-id]
                       [--endpoint-profile --ep]
                       [--hardware-revision --hr]
                       [--ig --instance-resource-group]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri --mu]
                       [--model]
                       [--name]
                       [--pc --product-code]
                       [--resource-group]
                       [--serial-number --sn]
                       [--software-revision --sr]
                       [--topic-path --tp]
                       [--topic-retain --tr {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

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.

--cq --custom-query

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

--description -d

Description.

--disabled

Estado del recurso.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments
Valores aceptados:	false, true

--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--eai --external-asset-id

Id. de recurso externo.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--endpoint-profile --ep

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

--hardware-revision --hr

Revisión de hardware.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--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

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

--manufacturer

Manufacturer.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--manufacturer-uri --mu

URI del fabricante.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--model

Model.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--name -n

Nombre del recurso.

--pc --product-code

Código del producto.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--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.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--software-revision --sr

Revisión de software.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--topic-path --tp

Ruta de acceso de tema predeterminada.

Propiedad	Valor
Grupo de parámetros:	MQTT Topic Default Arguments

--topic-retain --tr

Directiva predeterminada de retención de temas.

Propiedad	Valor
Grupo de parámetros:	MQTT Topic Default Arguments
Valores aceptados:	Keep, Never

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 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 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 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 --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--hardware-revision --hr]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {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

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.

--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 "".

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--dataset-publish-int --dpi

Intervalo de publicación predeterminado para conjuntos de datos.

Propiedad	Valor
Grupo de parámetros:	Dataset Default Arguments

--dataset-queue-size --dqs

Tamaño de cola predeterminado para conjuntos de datos.

Propiedad	Valor
Grupo de parámetros:	Dataset Default Arguments

--dataset-sample-int --dsi

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

Propiedad	Valor
Grupo de parámetros:	Dataset Default Arguments

--description -d

Description.

--disable

Deshabilite un recurso.

Propiedad	Valor
Valores aceptados:	false, true

--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--epi --event-publish-int

Intervalo de publicación predeterminado para eventos.

Propiedad	Valor
Grupo de parámetros:	Event Default Arguments

--eqs --event-queue-size

Tamaño de cola predeterminado para eventos.

Propiedad	Valor
Grupo de parámetros:	Event Default Arguments

--esi --event-sample-int

Intervalo de muestreo predeterminado (en milisegundos) para eventos.

Propiedad	Valor
Grupo de parámetros:	Event Default Arguments

--hardware-revision --hr

Revisión de hardware.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--manufacturer

Manufacturer.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--manufacturer-uri --mu

URI del fabricante.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--model

Model.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--pc --product-code

Código del producto.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--serial-number --sn

Número de serie.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--software-revision --sr

Revisión de software.

Propiedad	Valor
Grupo de parámetros:	Additional Info Arguments

--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.

Propiedad	Valor
Grupo de parámetros:	MQTT Topic Default Arguments

--topic-retain --tr

Directiva predeterminada de retención de temas.

Propiedad	Valor
Grupo de parámetros:	MQTT Topic Default Arguments
Valores aceptados:	Keep, Never

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

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

az iot ops asset

Comandos

az iot ops asset create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot ops asset delete

Ejemplos

Parámetros requeridos

az iot ops asset query

Ejemplos

Parámetros opcionales

az iot ops asset show

Ejemplos

Parámetros requeridos

az iot ops asset update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios