Azure IoT extension for Azure CLI
OTHER License
Bot releases are visible (Hide)
Published by digimaun about 2 years ago
Device Update
az iot device-update account
andaz iot device-update instance
now use the GA API version of 2022-10-01
.az iot device-update device
andaz iot device-update update
now use the GA API version of 2022-10-01
.az iot device-update device class list
adds support for --filter
when no --group-id
is provided.--account
, --instance
, and --resource-group
support setting default overridable values via config.
az config set
i.e. az config set defaults.adu_account=<name>
or az configure
i.e. az configure --defaults adu_account=<name>
.az iot device-update update init v5
for initializing (or generating) an import manifestaz iot device-update
command group remains under preview.Published by digimaun about 2 years ago
Device Update
update
and device
IoT Hub updates
az iot hub monitor-events
command to support an optional --message-count
argument.Published by digimaun over 2 years ago
General updates
Published by digimaun over 2 years ago
Device Update
The in preview az iot device-update
command group is now always available.
No environment variable is needed for activation.
account
and instance
related functionality againstDigital Twin updates
az dt model create
command to process input ontologies larger than 250 models in a single command run.IoT Central updates
Add support for device groups CRUD.
Add support for device attestation CRUD.
Add support for device/module properties/telemetry/command.
Add support for 2022-05-31 GA version.
IoT device updates
az iot device simulate
and az iot device send-d2c-message
support a --model-id
argument.Published by digimaun over 2 years ago
General updates
Azure Device Update
Introducing the Azure Device Update for IoT Hub root command group az iot device-update
.
To learn more about the service visit https://docs.microsoft.com/en-us/azure/iot-hub-device-update/.
IOT_CLI_ADU_ENABLED
to any valueaccount
and instance
related functionality.IoT device updates
Added device registration commands, az iot device registration create
to register a device to an individual
enrollment or an enrollment group. Currently, devices with symmetric key and x509 certificate authentication
are supported. Once registered, the device will show up in the linked IoT Hub and can be interacted with or
simulated using other az iot device
commands.
Added support for simulating device identities that use x509 thumbprint or CA authentication, impacting the
following commands:
az iot device simulate
az iot device send-d2c-message
Digital Twin updates
Added az dt job import
preview command group, which will allow users to create and manage jobs for bulk importing
models, twins and relationships to a Digital Twins instance. The bulk import data must be stored as a blob in
a user owned storage account and container.
Data History commands, under the az dt data-history
command group, are now GA.
Published by digimaun over 2 years ago
IoT Hub updates
IoT DPS updates
Added registration commands for individual enrollment groups:
az iot dps enrollment registration show
az iot dps enrollment registration delete
IoT Device Certification
Published by digimaun over 2 years ago
General updates
sys.excepthook
upon terminating monitor-events process in Py 3.9+ environments [IoT Hub, IoT Central].Digital Twins updates
Added optional --telemetry-source-time
parameter to az dt twin telemetry send
to allow users to
add a custom timestamp to the sent telemetry.
Updated both controlplane and dataplane SDKs to now use the newer 2021-06-30-preview
API version.
Added --no-wait
parameter to the following operations:
az dt create
az dt endpoint create
az dt private-endpoint create
Added az dt data-history
command group, which will allow users to configure a data history connection
for a Digital Twins instance using an Event Hub and Azure Data Explorer database. Once configured,
changes to the Digital Twins instance can be seen in the Azure Data Explorer database.
IoT Central updates
az iot central device edge module
az iot central device edge module list
az iot central device edge module restart
az iot central device edge module show
az iot central device edge manifest
az iot central device edge manifest show
az iot central device edge children
az iot central device edge children list
az iot central device edge children add
az iot central device edge children remove
IoT DPS updates
az iot dps compute-device-key
is deprecated use az iot dps enrollment-group compute-device-key
instead.az iot dps registration
is deprecated use az iot dps enrollment-group registration
instead.az iot dps registration delete
is deprecated use az iot dps enrollment-group registration delete
instead.az iot dps registration list
is deprecated use az iot dps enrollment-group registration list
instead.az iot dps registration show
is deprecated use az iot dps enrollment-group registration show
instead.Published by digimaun almost 3 years ago
IoT Central updates
Added missing "update" sub-commands for all commands supporting it:
az iot central device update
az iot central device-template update
az iot central file-upload-config update
az iot central organization update
az iot central user update
Added "compact" mode for az iot central device-template list
command:
When "-c" flag is passed, only Ids, display names and model types will be shown for the templates in the application.
Added az iot central device c2d-message purge
to purge cloud-to-device message queue
IoT DPS updates
Added RBAC support for DPS dataplane commands, similar to the RBAC support for IoT Hub.
The type of auth used to execute commands can be controlled with the "--auth-type" parameter
which accepts the values "key" or "login". The value of "key" is set by default.
When "--auth-type" has the value of "key", like before the CLI will auto-discover
a suitable policy when interacting with DPS.
When "--auth-type" has the value "login", an access token from the Azure CLI logged in principal
will be used for the operation.
The following commands currently support --auth-type
:
az iot dps enrollment
az iot dps enrollment-group
az iot dps registration
Update DPS dataplane SDK to use the newer 2021-10-01 API version. Most command
functionality has not changed. Updated commands include:
az iot dps enrollment create
and az iot dps enrollment update
support--device-info
Published by digimaun almost 3 years ago
IoT DPS updates
--login
with connection string still required az login
.Published by digimaun almost 3 years ago
General Updates
IoT Central updates
Fixed iot hub token leak for device twin show.
Adds new preview commands (v1.1-preview
)
az iot central query
)az iot central export destination
)az iot central export
)IoT DPS updates
Added az iot dps connection-string show
to show the DPS connection string with
similar support as the IoT Hub connection string show.
DPS supports connection string as a resource identifier with the --login
or -l
parameter, similar to IoT Hub Identifier Arguments.
DPS now supports auto resource and policy discovery. Resource group is no longer a
required parameter for az iot dps
instance interaction commands. Auto policy discovery ensures
that a policy with all the correct permissions is available and is used by the IoT
extension for all DPS operations.
az iot dps compute-device-key
now supports enrollment group identifiers in addition to
enrollment group symmetric key. Please take a look at the --help
docs for functionality
and usage highlights.
Improvements to help documentation for DPS functions.
IoT Hub updates
az iot hub device-identity create
supports a device scope argument via --device-scope
parameter.Published by digimaun about 3 years ago
Adds preview commands (v1.1-preview):
Adds x-ms-client-request-id header for each request
Breaking Changes
List commands like az iot central device list
and others,
now return list of items instead of a main dict with item ids as keys and items as values.
Involved commands:
az iot central device list
az iot central device-template list
az iot central api-token list
az iot central user list
Published by digimaun about 3 years ago
IoT Hub updates
0.10.16
causing IoT Hub command failure in Windows MSI environment.Published by digimaun about 3 years ago
0.10.17
+.IoT Central updates
IoT Hub updates
az iot device simulate
). Device simulation is experimental and subject to change.--help
docs for functionality and usage highlights.Published by digimaun about 3 years ago
IoT Central updates
Published by digimaun over 3 years ago
IoT Central updates
--interface-id
parameter for commands "device command run" , "device command history" changed to optional.IoT Hub updates
Decoding fix for az iot hub c2d-message receive
- the command will use the "ContentEncoding" header value (which indicates the message body encoding) or fallback to utf-8
to decode the received message body.
Addition for az iot hub generate-sas-token
- the command will allow offline generation of SAS tokens using a connection string (via --connection-string
).
Changes to Edge validation for set-modules
and edge deployment
creation:
By default only properties of system modules $edgeAgent
and $edgeHub
are validated against schemas installed with the IoT extension.
This can be disabled by using the --no-validation
switch.
Azure Digital Twins updates
Addition of the following commands
az dt reset
- Preview command which deletes all data entities from the target instance (models, twins, twin relationships).Published by digimaun over 3 years ago
General Update
2.17.1
Published by digimaun over 3 years ago
IoT Central updates
Public API GA update
--av
argument to specify the version of API for the requested operation.IoT Hub updates
Removed deprecated edge offline commands and artifacts.
Removed deprecated device-identity | module-identity show-connection-string commands.
Most commands against IoT Hub support Azure AD based access. The type of auth
used to execute commands can be controlled with the --auth-type
parameter
which accepts the values key
or login
. The value of key
is set by default.
When --auth-type
has the value of key
, like before the CLI will auto-discover
a suitable policy when interacting with iothub.
When --auth-type
has the value login
, an access token from the Azure CLI logged in principal
will be used for the operation.
The following commands currently remain with key based access only.
az iot hub monitor-events
az iot device c2d-message receive
az iot device c2d-message complete
az iot device c2d-message abandon
az iot device c2d-message reject
az iot device c2d-message purge
az iot device send-d2c-message
az iot device simulate
For more information about IoT Hub support for AAD visit: https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac
Azure Digital Twins updates
Addition of the following commands
az dt model delete-all
- Deletes all models associated with the Digital Twins instance.Published by digimaun over 3 years ago
IoT Hub updates
Fixed an issue where an explicit json null
could not be sent for the following commands:
az iot hub invoke-device-method
az iot hub invoke-module-method
When using az iot hub connection-string show
against all hubs in a group or subscription, the command will now
show a warning instead of raising an error if a problem occurs obtaining a connection-string from a particular hub.
Azure Digital Twins updates
Addition of the following commands
az dt twin delete-all
- Deletes all digital twins within a Digital Twins instance.az dt twin relationship delete-all
- Deletes all digital twin relationships within a Digital Twins instance.Fixed an issue in the following update commands where malformed json patch content would not raise an error
causing the process to call the respective service endpoint with a request payload containing an empty array. An error will now be raised.
az dt twin update
az dt twin relationship update
az dt twin component update
IoT Central updates
Addition of the following commands
az iot central device manual-failover
- Execute a manual failover of device across multiple IoT Hubsaz iot central device manual-failback
- Reverts the previously executed failover command by moving the device back to it's original IoT HubFor more information about device high availability visit https://github.com/iot-for-all/iot-central-high-availability-clients#readme
Published by digimaun over 3 years ago
Azure Digital Twins updates
Addition of the optional --etag
argument for the following commands:
az dt twin
[update
| delete
]az dt twin relationship
[update
| delete
]Addition of the optional --if-not-match
switch for the following commands:
az dt twin create
az dt twin relationship create
Published by digimaun over 3 years ago
Azure IoT Product Certification service updates
az iot product test create
sending malformed base64 string.Azure Digital Twins updates
az dt network
.IoT Hub updates