Skip to content

Commit b067bb5

Browse files
committed
Metadata and links updated, minor Acrolinx fixes to improve score
1 parent 97f5a65 commit b067bb5

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

articles/digital-twins/concepts-cli.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ titleSuffix: Azure Digital Twins
44
description: Learn about the Azure Digital Twins CLI command set.
55
author: baanders
66
ms.author: baanders
7-
ms.date: 03/31/2022
7+
ms.date: 04/09/2025
88
ms.topic: conceptual
99
ms.service: azure-digital-twins
1010
---
@@ -38,18 +38,18 @@ The Azure Digital Twins commands are part of the [Azure IoT extension for Azure
3838

3939
### CLI version requirements
4040

41-
If you're using the Azure CLI with PowerShell, your Azure CLI version should be 2.3.1 or above as a requirement of the extension package.
41+
If you're using the Azure CLI with PowerShell, your Azure CLI version should be 2.3.1 or greater as a requirement of the extension package.
4242

4343
You can check the version of your Azure CLI with this CLI command:
4444
```azurecli
4545
az --version
4646
```
4747

48-
For instructions on how to install or update the Azure CLI to a newer version, see [Install the Azure CLI](/cli/azure/install-azure-cli).
48+
For instructions on how to install or update the Azure CLI to a newer version, see [How to install the Azure CLI](/cli/azure/install-azure-cli).
4949

5050
### Get the extension
5151

52-
The Azure CLI will automatically prompt you to install the extension on the first use of a command that requires it.
52+
The Azure CLI automatically prompts you to install the extension on the first use of a command that requires it.
5353

5454
Otherwise, you can use the following command to install the extension yourself at any time (or update it if it turns out that you already have an older version). The command can be run in either the [Azure Cloud Shell](../cloud-shell/overview.md) or a [local Azure CLI](/cli/azure/install-azure-cli).
5555

@@ -59,7 +59,7 @@ az extension add --upgrade --name azure-iot
5959

6060
## Use special characters in different shells
6161

62-
Some `az dt` commands use special characters that may have to be escaped for proper parsing in certain shell environments. Use the tips in this section to help you know when to do this in your shell of choice.
62+
Some `az dt` commands use special characters that might have to be escaped for proper parsing in certain shell environments. Use the tips in this section to help you know when to escape special characters in your shell of choice.
6363

6464
### Bash
6565

@@ -69,7 +69,7 @@ Use these special character tips for Bash environments.
6969

7070
In many twin queries, the `$` character is used to reference the `$dtId` property of a twin. When using the [az dt twin query](/cli/azure/dt/twin#az-dt-twin-query) command to query in the Cloud Shell Bash environment, escape the `$` character with a backslash (`\`).
7171

72-
Here is an example of querying for a twin with a CLI command in the Cloud Shell Bash environment:
72+
Here's an example of querying for a twin with a CLI command in the Cloud Shell Bash environment:
7373

7474
```azurecli
7575
az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"
@@ -83,7 +83,7 @@ Use these special character tips for PowerShell environments.
8383

8484
Some commands, like [az dt twin create](/cli/azure/dt/twin#az-dt-twin-create), allow you to enter twin information in the form of inline JSON. When entering inline JSON in the PowerShell environment, escape double quote characters (`"`) inside the JSON with a backslash (`\`).
8585

86-
Here is an example of creating a twin with a CLI command in PowerShell:
86+
Here's an example of creating a twin with a CLI command in PowerShell:
8787

8888
```azurecli
8989
az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{\"Temperature\": 0.0}'
@@ -96,7 +96,8 @@ az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:
9696

9797
In many twin queries, the `$` character is used to reference the `$dtId` property of a twin. When using the [az dt twin query](/cli/azure/dt/twin#az-dt-twin-query) command to query in a PowerShell environment, escape the `$` character with a backtick character.
9898

99-
Here is an example of querying for a twin with a CLI command in PowerShell:
99+
Here's an example of querying for a twin with a CLI command in PowerShell:
100+
100101
```azurecli
101102
az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"
102103
```
@@ -109,7 +110,7 @@ Use these special character tips for the local Windows CMD.
109110

110111
Some commands, like [az dt twin create](/cli/azure/dt/twin#az-dt-twin-create), allow you to enter twin information in the form of inline JSON. When entering inline JSON in a local Windows CMD window, enclose the parameter value with double quotes (`"`) instead of single quotes (`'`), and escape double quote characters inside the JSON with a backslash (`\`).
111112

112-
Here is an example of creating a twin with a CLI command in the local Windows CMD:
113+
Here's an example of creating a twin with a CLI command in the local Windows CMD:
113114

114115
```azurecli
115116
az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties "{\"Temperature\": 0.0}"

0 commit comments

Comments
 (0)