Compartir a través de


az iot ops asset endpoint

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 endpoint . 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 perfiles de punto de conexión de recursos.

Comandos

Nombre Description Tipo Estado
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 endpoint 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 punto de conexión de 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.

El agente de Azure IoT OPC UA (versión preliminar) usa el mismo certificado de cliente para todos los canales seguros entre sí mismo y los servidores de OPC UA a los que se conecta.

az iot ops asset endpoint create --name
                                 --resource-group
                                 --ta
                                 [--ac]
                                 [--cert]
                                 [--cert-ref]
                                 [--cg]
                                 [--cl]
                                 [--clg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

Ejemplos

Cree un punto de conexión de recurso con autenticación de usuario anónima mediante la ubicación personalizada especificada.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --target-address {target_address}

Cree un punto de conexión de recurso con autenticación de usuario anónima 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 endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --target-address {target_address}

Cree un punto de conexión de recurso con autenticación de usuario con contraseña de nombre de usuario y certificados de propiedad preconfigurados con valores rellenados previamente. Las referencias de nombre de usuario y contraseña se establecen a través del controlador de la interfaz de almacenamiento de contenedor de Azure Keyvault.

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --cert secret=aio-opc-ua-broker-client-certificate thumbprint=000000000000000000 password=aio-opc-ua-broker-client-certificate-password

Cree un punto de conexión de recurso con autenticación de usuario con contraseña de nombre de usuario y configuración adicional con valores rellenados previamente (ejemplo de sintaxis de PowerShell).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Cree un punto de conexión de recurso con autenticación de usuario con contraseña de nombre de usuario y configuración adicional con valores rellenados previamente (ejemplo de sintaxis cmd).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Cree un punto de conexión de recurso con autenticación de usuario con contraseña de nombre de usuario y configuración adicional con valores rellenados previamente (ejemplo de sintaxis de Bash).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Parámetros requeridos

--name -n

Nombre del punto de conexión del recurso.

--resource-group -g

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

--ta --target-address

Dirección de destino. Debe ser una dirección local válida.

Parámetros opcionales

--ac --additional-config

Configuración adicional para el tipo de conectividad (por ejemplo: OPC UA, Modbus, ONVIF).

--cert

Pares clave=valor separados por espacios correspondientes a los certificados asociados al punto de conexión. Se admiten los siguientes valores de clave: secret (obligatorio), (obligatorio), thumbprint password.--cert se puede usar 1 o más veces. Revise los ejemplos de ayuda para ver el uso completo de parámetros.

--cert-ref --certificate-ref --cr

Referencia del certificado usado en la autenticación. Este método de autenticación de usuario aún no se admite.

--cg --cluster-resource-group

Grupo de recursos para el clúster.

--cl --custom-location

Ubicación personalizada que se usa para asociar el punto de conexión de recursos al clúster.

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

--cluster -c

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

--cluster-subscription --cs

Identificador de suscripción para el clúster.

--location -l

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

--password-ref --pr

Referencia de la contraseña usada en la autenticación.

--tags

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

--ur --username-reference

Referencia del nombre de usuario usado en la autenticación.

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

Elimine un punto de conexión de recurso.

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

Ejemplos

Elimine un punto de conexión de recurso.

az iot ops asset endpoint delete --name {asset_endpoint} -g {resource_group}

Parámetros requeridos

--name -n

Nombre del punto de conexión 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 endpoint 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 puntos de conexión de recursos.

az iot ops asset endpoint query [--ac]
                                [--am]
                                [--cl]
                                [--location]
                                [--resource-group]
                                [--ta]

Ejemplos

Consulte los puntos de conexión de recursos que admiten la autenticación anónima.

az iot ops asset endpoint query --authentication-mode Anonymous

Consulte los puntos de conexión de recursos que tienen la dirección de destino y la ubicación personalizada especificadas.

az iot ops asset endpoint query --target-address {target_address} --custom-location {custom_location}

Parámetros opcionales

--ac --additional-config

Configuración adicional para el tipo de conectividad (por ejemplo: OPC UA, Modbus, ONVIF).

--am --authentication-mode

Modo de autenticación.

--cl --custom-location

Ubicación personalizada que se usa para asociar el punto de conexión de recursos al clúster.

--location -l

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

--resource-group -g

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

--ta --target-address

Dirección de destino. Debe ser una dirección local válida.

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 endpoint 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 punto de conexión de recurso.

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

Ejemplos

Muestra los detalles de un punto de conexión de recurso.

az iot ops asset endpoint show --name {asset_endpoint} -g {resource_group}

Parámetros requeridos

--name -n

Nombre del punto de conexión 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 endpoint 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 punto de conexión de recurso.

Para actualizar los certificados de propiedad, use el grupo az iot ops asset endpoint certificatede comandos .

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--ac]
                                 [--am]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

Ejemplos

Actualice el modo de autenticación de un punto de conexión de recurso para usar la autenticación de usuario anónima.

az iot ops asset endpoint update --name {asset_endpoint} -g {resource_group} --authentication-mode Anonymous

Actualice la referencia de nombre de usuario y contraseña de un punto de conexión de recurso con valores rellenados previamente. Esto transformará el modo de autenticación en nombre de usuario-contraseña si aún no es así.

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password"

Actualice la dirección de destino de un punto de conexión de recurso y la configuración adicional con valores rellenados previamente (ejemplo de sintaxis de PowerShell).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Actualice la dirección de destino de un punto de conexión de recurso y una configuración adicional con valores rellenados previamente (ejemplo de sintaxis cmd).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Actualice la dirección de destino de un punto de conexión de recurso y una configuración adicional con valores rellenados previamente (ejemplo de sintaxis de Bash).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Parámetros requeridos

--name -n

Nombre del punto de conexión del recurso.

--resource-group -g

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

Parámetros opcionales

--ac --additional-config

Configuración adicional para el tipo de conectividad (por ejemplo: OPC UA, Modbus, ONVIF).

--am --authentication-mode

Modo de autenticación.

--cert-ref --certificate-ref --cr

Referencia del certificado usado en la autenticación. Este método de autenticación de usuario aún no se admite.

--password-ref --pr

Referencia de la contraseña usada en la autenticación.

--ta --target-address

Dirección de destino. Debe ser una dirección local válida.

--tags

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

--ur --username-reference

Referencia del nombre de usuario usado en la autenticación.

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.