az iot ops ns asset opcua

Note

This reference is part of the azure-iot-ops extension for the Azure CLI (version 2.70.0 or higher). The extension will automatically install the first time you run an az iot ops ns asset opcua command. Learn more about extensions.

Manage namespaced assets that point to OPC UA device endpoints.

For more information on OPC UA connectors, please see https://aka.ms/aio-opcua-quickstart.

Commands

Name	Description	Type	Status
az iot ops ns asset opcua create	Create an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua datapoint	Manage data points for OPC UA asset datasets in Device Registry namespaces.	Extension	GA
az iot ops ns asset opcua datapoint add	Add a datapoint to an OPC UA asset dataset in a Device Registry namespace.	Extension	GA
az iot ops ns asset opcua datapoint export	Export datapoints to file.	Extension	GA
az iot ops ns asset opcua datapoint import	Import datapoints from file.	Extension	GA
az iot ops ns asset opcua datapoint list	List data points for an OPC UA asset dataset in a Device Registry namespace.	Extension	GA
az iot ops ns asset opcua datapoint remove	Remove a datapoint from an OPC UA asset dataset in a Device Registry namespace.	Extension	GA
az iot ops ns asset opcua dataset	Manage datasets for OPC UA namespaced assets in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua dataset add	Add a dataset to an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua dataset export	Export datasets to file.	Extension	GA
az iot ops ns asset opcua dataset import	Import datasets from file.	Extension	GA
az iot ops ns asset opcua dataset list	List datasets for an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua dataset remove	Remove a dataset from an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua dataset show	Show details of a dataset for an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua dataset update	Update a dataset for an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event	Manage individual events for OPC UA asset event groups in Device Registry namespaces.	Extension	GA
az iot ops ns asset opcua event-group	Manage event groups for OPC UA namespaced assets in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event-group add	Add an event group to an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event-group export	Export event-groups to file.	Extension	GA
az iot ops ns asset opcua event-group import	Import event-groups from file.	Extension	GA
az iot ops ns asset opcua event-group list	List event groups for an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event-group remove	Remove an event group from an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event-group show	Show details of an event group for an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event-group update	Update an event group for an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua event add	Add an event to an OPC UA asset event group in a Device Registry namespace.	Extension	GA
az iot ops ns asset opcua event export	Export events to file.	Extension	GA
az iot ops ns asset opcua event import	Import events from file.	Extension	GA
az iot ops ns asset opcua event list	List events for an OPC UA asset event group in a Device Registry namespace.	Extension	GA
az iot ops ns asset opcua event remove	Remove an event from an OPC UA asset event group in a Device Registry namespace.	Extension	GA
az iot ops ns asset opcua mgmt-action	Manage actions within OPC UA asset management groups.	Extension	GA
az iot ops ns asset opcua mgmt-action add	Add an action to an OPC UA asset management group.	Extension	GA
az iot ops ns asset opcua mgmt-action export	Export management actions to file.	Extension	GA
az iot ops ns asset opcua mgmt-action import	Import management actions from file.	Extension	GA
az iot ops ns asset opcua mgmt-action list	List actions in an OPC UA asset management group.	Extension	GA
az iot ops ns asset opcua mgmt-action remove	Remove an action from an OPC UA asset management group.	Extension	GA
az iot ops ns asset opcua mgmt-group	Manage OPC UA asset management groups in an IoT Operations instance.	Extension	GA
az iot ops ns asset opcua mgmt-group add	Add a management group to an OPC UA asset.	Extension	GA
az iot ops ns asset opcua mgmt-group export	Export management groups to file.	Extension	GA
az iot ops ns asset opcua mgmt-group import	Import management groups from file.	Extension	GA
az iot ops ns asset opcua mgmt-group list	List management groups for an OPC UA asset.	Extension	GA
az iot ops ns asset opcua mgmt-group remove	Remove a management group from an OPC UA asset.	Extension	GA
az iot ops ns asset opcua mgmt-group show	Show details of a management group for an OPC UA asset.	Extension	GA
az iot ops ns asset opcua mgmt-group update	Update a management group for an OPC UA asset.	Extension	GA
az iot ops ns asset opcua update	Update an OPC UA namespaced asset in an IoT Operations instance.	Extension	GA

az iot ops ns asset opcua create

Create an OPC UA namespaced asset in an IoT Operations instance.

The device endpoint must be of type Microsoft.OpcUa.

az iot ops ns asset opcua create --device
                                 --endpoint --ep
                                 --instance
                                 --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--asset-type-ref --type-ref]
                                 [--attr --attribute]
                                 [--change-reference]
                                 [--dataset-dest --dsd]
                                 [--dataset-key-frame-count --dskfc]
                                 [--dataset-publish-int --dspi]
                                 [--dataset-queue-size --dsqs]
                                 [--dataset-sampling-int --dssi]
                                 [--dataset-start-inst --dss]
                                 [--description]
                                 [--disable {false, true}]
                                 [--display-name --dn]
                                 [--doc-uri --documentation-uri]
                                 [--eid --external-asset-id]
                                 [--evd --event-dest]
                                 [--event-filter-clause --evf]
                                 [--event-filter-type --evft]
                                 [--event-publish-int --evpi]
                                 [--event-queue-size --evqs]
                                 [--event-start-inst --evs]
                                 [--hardware-revision --hw-rev]
                                 [--manufacturer]
                                 [--manufacturer-uri --mfr-uri]
                                 [--model]
                                 [--pc --product-code]
                                 [--serial-number --sn]
                                 [--software-revision --sw-rev]
                                 [--tags]

Examples

Create a basic OPC UA asset

az iot ops ns asset opcua create --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --device myOpcuaDevice --endpoint myOpcuaEndpoint

Create an OPC UA asset with dataset configuration

az iot ops ns asset opcua create --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --device myOpcuaDevice --endpoint myOpcuaEndpoint --dataset-publish-int 1000 --dataset-sampling-int 500 --dataset-queue-size 5 --dataset-key-frame-count 1

Create an OPC UA asset with event configuration

az iot ops ns asset opcua create --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --device myOpcuaDevice --endpoint myOpcuaEndpoint --event-publish-int 2000 --event-queue-size 10

Create an OPC UA asset with MQTT destinations for datasets and events

az iot ops ns asset opcua create --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --device myOpcuaDevice --endpoint myOpcuaEndpoint --dataset-dest topic="factory/opcua/data" retain=Keep qos=Qos1 ttl=3600 --event-dest topic="factory/opcua/events" retain=Never qos=Qos1 ttl=3600

Create an OPC UA asset with start instances for datasets and events

az iot ops ns asset opcua create --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --device myOpcuaDevice --endpoint myOpcuaEndpoint --dataset-start-inst "ns=2;i=1001" --event-start-inst "ns=3;i=3001"

Create an OPC UA asset with event filter configuration

az iot ops ns asset opcua create --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --device myOpcuaDevice --endpoint myOpcuaEndpoint --event-filter-type "ns=2;i=5001" --event-filter-clause path="/EventType" type="ns=2;i=5001"

Required Parameters

--device -d

Device name.

--endpoint --ep

Device endpoint name.

--instance -i

The name of the Azure IoT Operations instance.

--name -n

Name of the asset.

--resource-group -g

The resource group of the Azure IoT Operations instance.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--asset-type-ref --type-ref

Space-separated list of asset type references.

Property	Value
Parameter group:	Additional Info Arguments

--attr --attribute

Space-separated key=value pairs for custom asset attributes.

Property	Value
Parameter group:	Additional Info Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--dataset-dest --dsd

Key=value pairs representing the destination for datasets. Allowed and required arguments are topic, retain, qos, and ttl for MQTT destinations. Allowed values for retain are Keep and Never and allowed values for qos are Qos0 and Qos1.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-key-frame-count --dskfc

Key frame count for datasets. Minimum: 0.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-publish-int --dspi

Publishing interval for datasets in milliseconds. Minimum: -1.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-queue-size --dsqs

Queue size for datasets. Minimum: 0.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-sampling-int --dssi

Sampling interval for datasets in milliseconds. Minimum: -1.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-start-inst --dss

Start instance for datasets.

Property	Value
Parameter group:	Default Dataset Arguments

--description

Description of the asset.

Property	Value
Parameter group:	Additional Info Arguments

--disable

Disable the asset.

Property	Value
Parameter group:	Additional Info Arguments
Accepted values:	false, true

--display-name --dn

Display name for the asset.

Property	Value
Parameter group:	Additional Info Arguments

--doc-uri --documentation-uri

Documentation URI for the asset.

Property	Value
Parameter group:	Additional Info Arguments

--eid --external-asset-id

External asset ID.

Property	Value
Parameter group:	Additional Info Arguments

--evd --event-dest

Key=value pairs representing the destination for events. Allowed arguments include: topic, retain, qos, and ttl for MQTT. Allowed values for retain are Keep and Never and allowed values for qos are Qos0 and Qos1.

Property	Value
Parameter group:	Default Event Arguments

--event-filter-clause --evf

Space-separated key=value pairs for event filter clauses. Allowed keys are path (required), type, and field. This parameter can be specified multiple times to add multiple clauses.

Property	Value
Parameter group:	Default Event Arguments

--event-filter-type --evft

Filter type definition ID for the default event configuration.

Property	Value
Parameter group:	Default Event Arguments

--event-publish-int --evpi

Publishing interval for events in milliseconds. Minimum: -1.

Property	Value
Parameter group:	Default Event Arguments

--event-queue-size --evqs

Queue size for events. Minimum: 0.

Property	Value
Parameter group:	Default Event Arguments

--event-start-inst --evs

Start instance for events.

Property	Value
Parameter group:	Default Event Arguments

--hardware-revision --hw-rev

Hardware revision information.

Property	Value
Parameter group:	Additional Info Arguments

--manufacturer

Manufacturer name.

Property	Value
Parameter group:	Additional Info Arguments

--manufacturer-uri --mfr-uri

Manufacturer URI.

Property	Value
Parameter group:	Additional Info Arguments

--model

Model name or number.

Property	Value
Parameter group:	Additional Info Arguments

--pc --product-code

Product code.

Property	Value
Parameter group:	Additional Info Arguments

--serial-number --sn

Serial number.

Property	Value
Parameter group:	Additional Info Arguments

--software-revision --sw-rev

Software revision information.

Property	Value
Parameter group:	Additional Info Arguments

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az iot ops ns asset opcua update

Update an OPC UA namespaced asset in an IoT Operations instance.

The device endpoint must be of type Microsoft.OpcUa.

az iot ops ns asset opcua update --instance
                                 --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--asset-type-ref --type-ref]
                                 [--attr --attribute]
                                 [--change-reference]
                                 [--dataset-dest --dsd]
                                 [--dataset-key-frame-count --dskfc]
                                 [--dataset-publish-int --dspi]
                                 [--dataset-queue-size --dsqs]
                                 [--dataset-sampling-int --dssi]
                                 [--dataset-start-inst --dss]
                                 [--description]
                                 [--disable {false, true}]
                                 [--display-name --dn]
                                 [--doc-uri --documentation-uri]
                                 [--eid --external-asset-id]
                                 [--evd --event-dest]
                                 [--event-filter-clause --evf]
                                 [--event-filter-type --evft]
                                 [--event-publish-int --evpi]
                                 [--event-queue-size --evqs]
                                 [--event-start-inst --evs]
                                 [--hardware-revision --hw-rev]
                                 [--manufacturer]
                                 [--manufacturer-uri --mfr-uri]
                                 [--model]
                                 [--pc --product-code]
                                 [--serial-number --sn]
                                 [--software-revision --sw-rev]
                                 [--tags]

Examples

Update an OPC UA asset's basic properties

az iot ops ns asset opcua update --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --description "Updated factory PLC" --display-name "Production Line Controller"

Update an OPC UA asset's dataset configuration

az iot ops ns asset opcua update --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --dataset-publish-int 500 --dataset-sampling-int 250 --dataset-queue-size 10 --dataset-key-frame-count 2

Update an OPC UA asset's event configuration

az iot ops ns asset opcua update --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --event-publish-int 1000 --event-queue-size 5

Update an OPC UA asset's destination configurations

az iot ops ns asset opcua update --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --dataset-dest topic="factory/opcua/data/updated" retain=Keep qos=Qos1 ttl=7200 --event-dest topic="factory/opcua/events/updated" retain=Never qos=Qos1 ttl=3600

Update an OPC UA asset's metadata and attributes

az iot ops ns asset opcua update --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --manufacturer "Automation Corp" --model "PLC-2000" --serial-number "PLC87654" --attribute location=factory-floor zone="production line"

Update an OPC UA asset's start instances for datasets and events

az iot ops ns asset opcua update --name myopcuaasset --instance myInstance -g myInstanceResourceGroup --dataset-start-inst "ns=2;i=1001" --event-start-inst "ns=3;i=3001"

Required Parameters

--instance -i

The name of the Azure IoT Operations instance.

--name -n

Name of the asset.

--resource-group -g

The resource group of the Azure IoT Operations instance.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--asset-type-ref --type-ref

Space-separated list of asset type references.

Property	Value
Parameter group:	Additional Info Arguments

--attr --attribute

Space-separated key=value pairs for custom asset attributes.

Property	Value
Parameter group:	Additional Info Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--dataset-dest --dsd

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-key-frame-count --dskfc

Key frame count for datasets. Minimum: 0.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-publish-int --dspi

Publishing interval for datasets in milliseconds. Minimum: -1.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-queue-size --dsqs

Queue size for datasets. Minimum: 0.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-sampling-int --dssi

Sampling interval for datasets in milliseconds. Minimum: -1.

Property	Value
Parameter group:	Default Dataset Arguments

--dataset-start-inst --dss

Start instance for datasets.

Property	Value
Parameter group:	Default Dataset Arguments

--description

Description of the asset.

Property	Value
Parameter group:	Additional Info Arguments

--disable

Disable the asset.

Property	Value
Parameter group:	Additional Info Arguments
Accepted values:	false, true

--display-name --dn

Display name for the asset.

Property	Value
Parameter group:	Additional Info Arguments

--doc-uri --documentation-uri

Documentation URI for the asset.

Property	Value
Parameter group:	Additional Info Arguments

--eid --external-asset-id

External asset ID.

Property	Value
Parameter group:	Additional Info Arguments

--evd --event-dest

Property	Value
Parameter group:	Default Event Arguments

--event-filter-clause --evf

Space-separated key=value pairs for event filter clauses. Allowed keys are path (required), type, and field. This parameter can be specified multiple times to add multiple clauses.

Property	Value
Parameter group:	Default Event Arguments

--event-filter-type --evft

Filter type definition ID for the default event configuration.

Property	Value
Parameter group:	Default Event Arguments

--event-publish-int --evpi

Publishing interval for events in milliseconds. Minimum: -1.

Property	Value
Parameter group:	Default Event Arguments

--event-queue-size --evqs

Queue size for events. Minimum: 0.

Property	Value
Parameter group:	Default Event Arguments

--event-start-inst --evs

Start instance for events.

Property	Value
Parameter group:	Default Event Arguments

--hardware-revision --hw-rev

Hardware revision information.

Property	Value
Parameter group:	Additional Info Arguments

--manufacturer

Manufacturer name.

Property	Value
Parameter group:	Additional Info Arguments

--manufacturer-uri --mfr-uri

Manufacturer URI.

Property	Value
Parameter group:	Additional Info Arguments

--model

Model name or number.

Property	Value
Parameter group:	Additional Info Arguments

--pc --product-code

Product code.

Property	Value
Parameter group:	Additional Info Arguments

--serial-number --sn

Serial number.

Property	Value
Parameter group:	Additional Info Arguments

--software-revision --sw-rev

Software revision information.

Property	Value
Parameter group:	Additional Info Arguments

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

Feedback

Was this page helpful?

Share via

az iot ops ns asset opcua

Commands

az iot ops ns asset opcua create

Examples

Required Parameters

Optional Parameters

az iot ops ns asset opcua update

Examples

Required Parameters

Optional Parameters

Feedback