Share via

az iot ops asset

  • Vista previa
  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.46.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.

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

Administrar recursos.

Comandos

Nombre Description Tipo Estado
az iot ops asset create

Cree un recurso.

 Extensión Vista previa
az iot ops asset data-point

Administrar puntos de datos en un recurso.

 Extensión Vista previa
az iot ops asset data-point add

Agregue un punto de datos a un recurso.

 Extensión Vista previa
az iot ops asset data-point export

Exportar puntos de datos en un recurso.

 Extensión Vista previa
az iot ops asset data-point import

Importe puntos de datos en un recurso.

 Extensión Vista previa
az iot ops asset data-point list

Enumere los puntos de datos de un recurso.

 Extensión Vista previa
az iot ops asset data-point remove

Quite un punto de datos de un recurso.

 Extensión Vista previa
az iot ops asset delete

Eliminar un recurso.

 Extensión Vista previa
az iot ops asset endpoint

Administrar perfiles de punto de conexión de recursos.

 Extensión Vista previa
az iot ops asset endpoint certificate

Administrar certificados propiedad en un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint certificate add

Agregue un certificado propiedad a un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint certificate list

Enumera los certificados propiedad de un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint certificate remove

Quite un certificado de propiedad en un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint create

Cree un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint delete

Elimine un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint query

Consulte Resource Graph para los puntos de conexión de recursos.

 Extensión Vista previa
az iot ops asset endpoint show

Mostrar un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset endpoint update

Actualice un punto de conexión de recurso.

 Extensión Vista previa
az iot ops asset event

Administrar eventos en un recurso.

 Extensión Vista previa
az iot ops asset event add

Agregue un evento a un recurso.

 Extensión Vista previa
az iot ops asset event export

Exportar eventos en un recurso.

 Extensión Vista previa
az iot ops asset event import

Importar eventos en un recurso.

 Extensión Vista previa
az iot ops asset event list

Enumerar eventos en un recurso.

 Extensión Vista previa
az iot ops asset event remove

Quite un evento en un recurso.

 Extensión Vista previa
az iot ops asset query

Consulte resource Graph para los recursos.

 Extensión Vista previa
az iot ops asset show

Mostrar un recurso.

 Extensión Vista previa
az iot ops asset update

Actualice un recurso.

 Extensión Vista previa

az iot ops asset create

Vista previa

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

Cree un recurso.

Debe proporcionarse la ubicación personalizada o el nombre del clúster. Este comando comprobará la existencia de la ubicación personalizada y el clúster asociados y garantizará que ambas estén configuradas correctamente con la extensión microsoft.deviceregistry.assets.

Se debe definir al menos un punto de datos o evento durante la creación de recursos.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--cl]
                        [--clrg]
                        [--cls]
                        [--cluster]
                        [--cluster-resource-group]
                        [--cluster-subscription]
                        [--data]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Ejemplos

Cree un recurso mediante la ubicación personalizada especificada.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data data_source={data_source}

Cree un recurso mediante la ubicación personalizada y el grupo de recursos especificados para la ubicación personalizada. El grupo de recursos debe incluirse si hay varias ubicaciones personalizadas con el mismo nombre dentro de una suscripción.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --endpoint {endpoint} --data data_source={data_source}

Cree un recurso con el nombre de clúster especificado. El grupo de recursos debe incluirse si hay varios clústeres con el mismo nombre dentro de una suscripción.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --cluster-resource-group {cluster_resource_group} --endpoint {endpoint} --event event_notifier={event_notifier}

Cree un recurso con el nombre de clúster y la ubicación personalizada especificados.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --custom-location {custom_location} --endpoint {endpoint} --event event_notifier={event_notifier}

Cree un recurso con los valores predeterminados de evento y punto de datos personalizados.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval} --event event_notifier={event_notifier}

Cree un recurso con tipo de recurso personalizado, descripción, uri de documentación, identificador de recurso externo, revisión de hardware, código de producto y revisión de software.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision} --data data_source={data_source}

Cree un recurso con dos eventos, fabricante, URI de fabricante, modelo, número de serie.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --event capability_id={capability_id} event_notifier={event_notifier} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --event event_notifier={event_notifier} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

Cree un recurso deshabilitado con dos puntos de datos.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --disable --data capability_id={capability_id} data_source={data_source} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --data data_source={data_source}

Cree un recurso con los valores rellenados previamente especificados.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint example.com --data capability_id=myTagId data_source=NodeID1 name=myTagName1 observability_mode=counter sampling_interval=10 queue_size=2 --data data_source=NodeID2 --data-publish-int 1000 --data-queue-size 1 --data-sample-int 30 --asset-type customAsset --description 'Description for a test asset.' --documentation-uri www.help.com --external-asset-id 000-000-0000 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10

Parámetros requeridos

--endpoint

Nombre del punto de conexión del recurso.

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

--asset-type --at

Tipo de recurso.

--cl --custom-location

Ubicación personalizada que se usa para asociar un recurso al clúster.

--clrg --custom-location-resource-group

Grupo de recursos para la ubicación personalizada.

--cls --custom-location-subscription

Identificador de suscripción para la ubicación personalizada. Si no se proporciona, se usará el identificador de suscripción de recurso.

--cluster -c

Clúster al que se va a asociar el recurso.

--cluster-resource-group --crg

Grupo de recursos para el clúster.

--cluster-subscription --cs

Identificador de suscripción para el clúster. Si no se proporciona, se usará el identificador de suscripción de recurso.

--data

Pares clave=valor separados por espacios correspondientes a las propiedades del punto de datos que se va a crear. Se admiten los siguientes valores de clave: capability_id, data_source (obligatorio), name, observability_mode (none, gauge, counter, histogram o log), sampling_interval (int), queue_size (int). --data se puede usar 1 o más veces. Revise los ejemplos de ayuda para ver el uso completo de parámetros.

--data-publish-int --dpi

Intervalo de publicación predeterminado para puntos de datos.

valor predeterminado: 1000
--data-queue-size --dqs

Tamaño de cola predeterminado para puntos de datos.

valor predeterminado: 1
--data-sample-int --dsi

Intervalo de muestreo predeterminado (en milisegundos) para los puntos 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.

--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: capability_id, event_notifier (obligatorio), name, observability_mode (none, gauge, counter, histogram o log), 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.

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

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

Vista previa

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

Eliminar un recurso.

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

Ejemplos

Eliminar un recurso.

az iot ops asset delete --name {asset_name} -g {resource_group}

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

Vista previa

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

Consulte resource Graph para los recursos.

az iot ops asset query [--asset-type]
                       [--cl]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint]
                       [--hardware-revision]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]

Ejemplos

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

az iot ops asset query -g {resource_group} --disabled

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

az iot ops asset query --model {model} --manufacturer {manufacturer} --serial-number {serial_number}

Parámetros opcionales

--asset-type --at

Tipo de recurso.

--cl --custom-location

Ubicación personalizada que se usa para asociar un recurso al clúster.

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

Nombre del punto de conexión del recurso.

--hardware-revision --hr

Revisión de hardware.

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

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

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

Vista previa

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

Mostrar un recurso.

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

Ejemplos

Muestra los detalles de un recurso.

az iot ops asset show --name {asset_name} -g {resource_group}

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

Vista previa

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

Actualice un recurso.

Para actualizar los puntos de datos y los eventos, use los grupos az iot ops asset data-point de comandos y az iot ops asset events respectivamente.

az iot ops asset update --name
                        --resource-group
                        [--asset-type]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Ejemplos

Actualice los valores predeterminados del punto de datos y del evento de un recurso.

az iot ops asset update --name {asset_name} -g {resource_group} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval}

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

az iot ops asset update --name {asset_name} -g {resource_group} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision}

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

az iot ops asset update --name {asset_name} -g {resource_group} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

Deshabilite un recurso.

az iot ops asset update --name {asset_name} -g {resource_group} --disable

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

--asset-type --at

Tipo de recurso.

--data-publish-int --dpi

Intervalo de publicación predeterminado para puntos de datos.

--data-queue-size --dqs

Tamaño de cola predeterminado para puntos de datos.

--data-sample-int --dsi

Intervalo de muestreo predeterminado (en milisegundos) para los puntos 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.

--eai --external-asset-id

Id. de recurso externo.

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

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.