Releases: Azure/azure-iot-cli-extension
Releases · Azure/azure-iot-cli-extension
azure-iot 0.9.8
General change
- With
v0.9.8
of the IoT extension, the minimum Azure CLI version has been bumped to2.3.1
. This reflects a minimum desired experience we want for our users. - If you cannot support at least Azure CLI v 2.3.1, then prior versions of the extension can be installed.
Introducing commands for the Azure IoT Product Certification service
- A new preview IoT root command group
az iot product
has been added- Use
az iot product requirement
to manage product certification requirements - Use
az iot product test
to manage device tests for certification- The product test command group encompasses test cases, runs and tasks
- Use
IoT Central updates
- Introduces the
az iot central app user
preview command group for managing application users and service principals - Introduces the
az iot central app api-token
preview command group for managing application api tokens - Removal of deprecated command groups and commands
IoT Hub updates
- All prior existing
... show-connection-string
based commands are deprecated in favor of... connection-string show
canonical Az CLI style.- The show connection string command for a target IoT Hub has moved to the IoT extension.
az iot hub connection-string show
supports a--default-eventhub
flag which indicates the operation will construct a connection string for the default eventhub endpoint of the target IoT Hub.
- Export/Import device identity commands support reading blob container SAS URI's via file
Digital Twins updates
- The 'location' argument for
az dt create
is now optional. If no location is provided, the location of the target resource group is used.
azure-cli-iot-ext 0.8.10
- The "azure-cli-iot-ext" CLI extension has been deprecated since early 2020. This release merely increases the visibility of deprecation by updating the package description, command group descriptions and showing warnings when commands are run.
- The "azure-iot" extension replaces the legacy extension. You should never have both installed at the same time.
- The legacy extension is scheduled for removal from the extension index after 09/15/2020.
- For more information, see https://github.com/Azure/azure-iot-cli-extension#news
azure-iot 0.9.7
Refreshes commands for the Azure IoT Plug & Play summer refresh
- The existing Plug & Play preview commands across Azure CLI and the IoT extension have been removed and replaced with a completely new commands. If you still need the legacy preview experience, then you can leverage older versions of the CLI and extension.
- The new commands exist entirely in the extension with the following command groups:
az iot pnp repo
## For tenant repository configurationaz iot pnp model
## For managing repository models and related contentaz iot pnp role-assignment
## For managing role assignments for model repo assetsaz iot pnp twin
## For interacting with the digital twin of a Plug & Play device
Introduces new preview Azure IoT Central commands
az iot central app monitor-properties
az iot central app validate-properties
az iot central app device run-command
az iot central app device show-command-history
az iot central app device show-credentials
Device Provisioning Service update
- DPS enrollments now support the
custom
allocation policy resolving issue #200
azure-iot 0.9.6
- Fixes event monitor initialization issue.
azure-iot 0.9.5
- IoT Hub commands now support dynamic privileged policy discovery.
iothubhowner
is no longer relied on. Instead any policy that hasRegistryWrite
,ServiceConnect
andDeviceConnect
permissions will be used. - Monitoring commands (such as for
central
orhub
) support module Id filter. Also it is more clear that an event comes from a module. - Improved validation of central telemetry.
- Digital Twin endpoint create commands now support custom subscription options.
azure-iot 0.9.4
Azure Digital Twins Public Preview - CLI release.
The public preview service will be available soon.
Introducing 35 new commands in the following command groups:
- az dt
- az dt endpoint
- az dt model
- az dt role-assignment
- az dt route
- az dt twin
- az dt twin relationship
- az dt twin telemety
azure-iot 0.9.3
Content
- IoT Hub device identity import/export commands support usage via managed service identity using the
--auth-type
argument. - Adds preview command group
az iot central app device
- Adds preview command
az iot central app device create
- Adds preview command
az iot central app device show
- Adds preview command
az iot central app device list
- Adds preview command
az iot central app device delete
- Adds preview command
az iot central app device registration-info
- Adds preview command
az iot central app device registration-summary
- Adds preview command
- Adds preview command group
az iot central app device-template
- Adds preview command
az iot central app device-template create
- Adds preview command
az iot central app device-template show
- Adds preview command
az iot central app device-template list
- Adds preview command
az iot central app device-template delete
- Adds preview command
az iot central app device-template map
- Adds preview command
- Changed how results are displayed in
az iot central app validate-messages
Examples:
Get device registration information.
az iot central app device registration-info --app-id AppId -d DeviceId
Get registration summary of all devices.
az iot central app device registration-summary --app-id AppId
Validate message payload sent by the device to IoT Central.
az iot central app validate-messages --app-id AppId -d DeviceId
Get a mapping of device template name to device template id.
az iot central app device-template map --app-id AppId
Known issues:
- The following preview commands will retrieve at most 25 results
az iot central app device list
az iot central app device-template list
az iot central app device-template map
azure-iot 0.9.2
- Resolves issue #156. Device and module twin update operations provide explicit patch arguments (--desired, --tags). Usage of the generic update arguments (i.e. --set) are deprecated.
- Adds preview command
az iot central app validate-messages
- Remove Py 2.7 remnants from setup manifest.
azure-iot 0.9.1
Device Provisioning Service update
- Adds edge configuration argument for creating or updating enrollment[groups]
- Use
--edge-enabled
- Use
For example
- Create an enrollment group with edge enabled
az iot dps enrollment-group create --dps-name MyDPS --enrollment-id MyEnrollmentGroup -g MyRG --edge-enabled
- Update to turn on edge configuration
az iot dps enrollment update --dps-name MyDPS --enrollment-id MyEnrollmentGroup -g MyRG --edge-enabled
- Update to turn off edge configuration
az iot dps enrollment update --dps-name MyDPS --enrollment-id MyEnrollmentGroup -g MyRG --edge-enabled False
azure-iot 0.9.0
- Extension package has been renamed to
azure-iot
. - IoT Hub SDK refresh. Service calls (except for
az iot dt
commands) point to api-version2019-10-01
. - Breaking change: Evaluating an edge deployment/hub configuration SYSTEM metric (via show-metric) will return non-manipulated query output.
- This means the result is always a collection of objects.
- Breaking change: Removed long since deprecated parameter
--config-id
from edge deployments.- Use
--deployment-id
or-d
instead.
- Use
- When creating ADM module configurations, the target condition starting with 'from devices.modules where' is required and enforced.
- Help text for ADM module configurations has been updated with proper target condition syntax for module criteria.