Remove CLI warnings

baanders · baanders · commit 41b4e762d8bd · 2025-04-17T22:28:49.000-07:00
diff --git a/articles/digital-twins/concepts-3d-scenes-studio.md b/articles/digital-twins/concepts-3d-scenes-studio.md
@@ -43,7 +43,7 @@ To share your scenes with someone else, the recipient will need at least *Reader
 ## Set up
 
 To work with 3D Scenes Studio, you'll need the following required resources:
-* An [Azure Digital Twins instance](how-to-set-up-instance-portal.md)
+* An [Azure Digital Twins instance](how-to-set-up-instance-cli.md)
     * You'll need *Azure Digital Twins Data Owner* or *Azure Digital Twins Data Reader* access to the instance
     * The instance should be populated with [models](concepts-models.md) and [twins](concepts-twins-graph.md)
 
diff --git a/articles/digital-twins/concepts-cli.md b/articles/digital-twins/concepts-cli.md
@@ -24,8 +24,6 @@ Some of the actions you can do using the command set include:
 
 The command set is called `az dt`, and is part of the [Azure IoT extension for Azure CLI](https://github.com/Azure/azure-iot-cli-extension). You can view the full list of commands and their usage as part of the reference documentation for the `az iot` command set: [az dt command reference](/cli/azure/dt).
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 ## Uses (deploy and validate)
 
 Apart from generally managing your instance, the CLI is also a useful tool for deployment and validation.
diff --git a/articles/digital-twins/how-to-create-app-registration.md b/articles/digital-twins/how-to-create-app-registration.md
@@ -13,8 +13,6 @@ ms.service: azure-digital-twins
 
 This article describes how to create an [Microsoft Entra ID](../active-directory/fundamentals/active-directory-whatis.md) *app registration* that can access Azure Digital Twins. This article includes steps for the [Azure portal](https://portal.azure.com) and the [Azure CLI](/cli/azure/what-is-azure-cli).
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 When working with Azure Digital Twins, it's common to interact with your instance through client applications. Those applications need to authenticate with Azure Digital Twins, and some of the [authentication mechanisms](how-to-authenticate-client.md) that apps can use involve an app registration.
 
 The app registration isn't required for all authentication scenarios. However, if you're using an authentication strategy or code sample that does require an app registration, this article shows you how to set one up and grant it permissions to the Azure Digital Twins APIs. It also covers how to collect important values that you need to use the app registration when authenticating.
@@ -236,8 +234,6 @@ The app registration should show up in the list along with the role you assigned
 
 # [CLI](#tab/cli)
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 Use the [az dt role-assignment create](/cli/azure/dt/role-assignment#az-dt-role-assignment-create) command to assign the role (you must have [sufficient permissions](how-to-set-up-instance-cli.md#prerequisites-permission-requirements) in the Azure subscription). The command requires you to pass in the name of the role you want to assign, the name of your Azure Digital Twins instance, and either the name or the object ID of the app registration.
 
 ```azurecli-interactive
diff --git a/articles/digital-twins/how-to-create-data-history-connection.md b/articles/digital-twins/how-to-create-data-history-connection.md
@@ -165,9 +165,7 @@ Now that you created the required resources, use the command in this section to
 
 This command also creates three tables in your Azure Data Explorer database to store twin property updates, relationship lifecycle events, and twin lifecycle events, respectively. For more information about these types of historized data and their corresponding Azure Data Explorer tables, see [Data types and schemas](concepts-data-history.md#data-types-and-schemas).
 
-# [CLI](#tab/cli) 
-
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
+# [CLI](#tab/cli)
 
 Use the command in this section to create a data history connection and the tables in Azure Data Explorer. The command always creates a table for historized twin property updates, and it includes parameters to create the tables for relationship lifecycle and twin lifecycle events.
 
diff --git a/articles/digital-twins/how-to-create-endpoints.md b/articles/digital-twins/how-to-create-endpoints.md
@@ -16,8 +16,6 @@ This article explains how to create an *endpoint* for Azure Digital Twin events
 
 Routing [event notifications](concepts-event-notifications.md) from Azure Digital Twins to downstream services or connected compute resources is a two-step process: create endpoints, then create event routes that send data to those endpoints. This article covers the first step, setting up endpoints that can receive the events. Later, you can create [event routes](how-to-create-routes.md) that specify which events generated by Azure Digital Twins are delivered to which endpoints.
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 ## Prerequisites
 
 * An Azure account, which you can [set up for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
@@ -84,8 +82,6 @@ Now the Event Grid topic, event hub, or Service Bus topic is available as an end
 
 # [CLI](#tab/cli) 
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 The following examples show how to create endpoints using the [az dt endpoint create](/cli/azure/dt/endpoint/create) command for the [Azure Digital Twins CLI](/cli/azure/dt). Replace the placeholders in the commands with the details of your own resources.
 
 To create an Event Grid endpoint:
diff --git a/articles/digital-twins/how-to-create-routes.md b/articles/digital-twins/how-to-create-routes.md
@@ -33,8 +33,6 @@ Next, follow the instructions below if you intend to use the Azure CLI while fol
 
 [!INCLUDE [azure-cli-prepare-your-environment-h3.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-h3.md)]
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 ## Create an event route
 
 After [creating an endpoint](how-to-create-endpoints.md), you'll need to define an *event route* to actually send data to the endpoint. These routes let developers wire up event flow, throughout the system and to downstream services. A single route can allow multiple notifications and event types to be selected. Read more about event routes in [Endpoints and event routes](concepts-route-events.md).
@@ -78,8 +76,6 @@ When finished, select the **Save** button to create your event route.
 
 # [CLI](#tab/cli2)
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 Routes can be managed using the [az dt route](/cli/azure/dt/route) commands for the Azure Digital Twins CLI. 
 
 For more information about using the CLI and what commands are available, see [Azure Digital Twins CLI command set](concepts-cli.md).
diff --git a/articles/digital-twins/how-to-enable-private-link.md b/articles/digital-twins/how-to-enable-private-link.md
@@ -168,8 +168,6 @@ Once a private endpoint has been created for your Azure Digital Twins instance,
 
 For more information and examples, see the [az dt network private-endpoint reference documentation](/cli/azure/dt/network/private-endpoint).
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 ### Get more Private Link information
 
 You can get more information about the Private Link status of your instance with the [az dt network private-link](/cli/azure/dt/network/private-link) commands. Operations include:
@@ -202,8 +200,6 @@ To disable or enable public network access in the [Azure portal](https://portal.
 
 # [CLI](#tab/cli-2)
 
-[!INCLUDE [digital-twins-cli-issue.md](includes/digital-twins-cli-issue.md)]
-
 In the Azure CLI, you can disable or enable public network access by adding a `--public-network-access` parameter to the `az dt create` command. While this command can also be used to create a new instance, you can use it to edit the properties of an existing instance by providing it the name of an instance that already exists. (For more information about this command, see its [reference documentation](/cli/azure/dt#az-dt-create) or the [general instructions for setting up an Azure Digital Twins instance](how-to-set-up-instance-cli.md#create-the-azure-digital-twins-instance)).
 
 To disable public network access for an Azure Digital Twins instance, use the `--public-network-access` parameter like this:
diff --git a/articles/digital-twins/how-to-ingest-iot-hub-data.md b/articles/digital-twins/how-to-ingest-iot-hub-data.md
@@ -53,8 +53,6 @@ You then need to create one twin using this model. Use the following command to
 az dt twin create  --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{"Temperature": 0.0}'
 ```
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 When the twin is created successfully, the CLI output from the command should look something like this:
 ```json
 {
diff --git a/articles/digital-twins/how-to-set-up-instance-cli.md b/articles/digital-twins/how-to-set-up-instance-cli.md
@@ -44,8 +44,6 @@ Use these values in the following [az dt command](/cli/azure/dt) to create the i
 az dt create --dt-name <name-for-your-Azure-Digital-Twins-instance> --resource-group <your-resource-group> --location <region>
 ```
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 There are several optional parameters that can be added to the command to specify additional things about your resource during creation, including creating a managed identity for the instance or enabling/disabling public network access. For a full list of supported parameters, see the [az dt create](/cli/azure/dt#az-dt-create) reference documentation.
 
 ### Create the instance with a managed identity
diff --git a/articles/digital-twins/includes/digital-twins-cli-issue.md b/articles/digital-twins/includes/digital-twins-cli-issue.md
diff --git a/articles/digital-twins/includes/digital-twins-cli.md b/articles/digital-twins/includes/digital-twins-cli.md
@@ -9,8 +9,6 @@ ms.author: baanders
 
 ### Set up CLI session
 
-[!INCLUDE [digital-twins-cli-issue](digital-twins-cli-issue.md)]
-
 To start working with Azure Digital Twins in the CLI, the first thing to do is sign in and set the CLI context to your subscription for this session. Run these commands in your CLI window:
 
 ```azurecli-interactive
diff --git a/articles/digital-twins/troubleshoot-error-403-digital-twins.md b/articles/digital-twins/troubleshoot-error-403-digital-twins.md
@@ -54,8 +54,6 @@ If you're an Owner on the subscription, you can run this command yourself. If yo
 az dt role-assignment create --dt-name <your-Azure-Digital-Twins-instance> --assignee "<your-Azure-AD-email>" --role "Azure Digital Twins Data Owner"
 ```
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 For more information about this role requirement and the assignment process, see [Set up your user's access permissions](how-to-set-up-instance-CLI.md#set-up-user-access-permissions).
 
 If you have this role assignment already and you're using a Microsoft Entra app registration to authenticate a client app, you can continue to the next solution if this solution didn't resolve the 403 issue.
diff --git a/articles/digital-twins/troubleshoot-error-azure-digital-twins-explorer-authentication.md b/articles/digital-twins/troubleshoot-error-azure-digital-twins-explorer-authentication.md
@@ -54,8 +54,6 @@ If you're an Owner on the subscription, you can run this command yourself. If yo
 az dt role-assignment create --dt-name <your-Azure-Digital-Twins-instance> --assignee "<your-Azure-AD-email>" --role "<role-name>"
 ```
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 For more details about this role requirement and the assignment process, see [Set up your user's access permissions](how-to-set-up-instance-CLI.md#set-up-user-access-permissions).
 
 ## Next steps
diff --git a/articles/digital-twins/troubleshoot-error-cli-parse.md b/articles/digital-twins/troubleshoot-error-cli-parse.md
@@ -13,8 +13,6 @@ ms.date: 04/11/2025
 
 This article describes causes and resolution steps for various "parse failed" errors while running [az dt](/cli/azure/dt) commands in the Azure CLI.
 
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
 ## Symptoms
 
 While attempting to run select `az dt` commands in an Azure CLI environment, you receive an error indicating that the command wasn't parsed correctly. The error message might include the words *parse failed* or *failed to parse*, or partial text from your command might be marked as *unrecognized arguments.*
diff --git a/articles/digital-twins/troubleshoot-known-issues.md b/articles/digital-twins/troubleshoot-known-issues.md
@@ -6,7 +6,7 @@ author: baanders
 ms.author: baanders
 ms.topic: troubleshooting
 ms.service: azure-digital-twins
-ms.date: 03/17/2025
+ms.date: 04/17/2025
 ---
 
 # Azure Digital Twins known issues
@@ -21,14 +21,6 @@ This article provides information about known issues associated with Azure Digit
 | --- | --- | --- |
 | If you're using Azure&nbsp;Digital&nbsp;Twins with a private endpoint/Private Link, this issue will affect you when trying to view your instance in Azure&nbsp;Digital&nbsp;Twins Explorer. | Azure Digital Twins Explorer does not offer support for private endpoints. | You can deploy your own version of the Azure Digital Twins Explorer codebase privately in the cloud. For instructions on how to do this, see [Azure Digital Twins Explorer: Running in the cloud](https://github.com/Azure-Samples/digital-twins-explorer#running-in-the-cloud). Alternatively, you can manage your Azure Digital Twins instance using the [APIs and SDKs](./concepts-apis-sdks.md) instead. |
 
-## az dt commands fail in Azure CLI version 2.70
-
-**Issue description:** CLI commands from the `az dt` command set fail in version 2.70 of the Azure CLI. The error message ends in *AttributeError: 'CredentialAdaptor' object has no attribute 'signed_session'*. 
-
-| Does this affect me? | Cause | Resolution |
-| --- | --- | --- |
-| If you're using version 2.70 of the Azure CLI, this affects all `az dt` CLI commands. | This is a [known issue](https://github.com/Azure/azure-cli/issues/31042) with version 2.70 of the Azure CLI. | To bypass this issue, use the local Azure CLI (not Cloud Shell) and downgrade your CLI to version 2.69. You can revert to an earlier version by [uninstalling the Azure CLI](/cli/azure/install-azure-cli-windows?pivots=winget#uninstall) and then [reinstalling](/cli/azure/install-azure-cli-windows?pivots=winget#install-or-update) the specific CLI version. On Windows, the reinstall command is `winget install --exact --id Microsoft.AzureCLI --version 2.69.0`. |
-
 ## "400 Client Error: Bad Request" in Cloud Shell
 
 **Issue description:** Commands in Cloud Shell running at *https://shell.azure.com* may intermittently fail with the error "400 Client Error: Bad Request for url: `http://localhost:50342/oauth2/token`", followed by full stack trace.
@@ -53,6 +45,14 @@ This article provides information about known issues associated with Azure Digit
 | --- | --- | --- |
 | `DefaultAzureCredential` is used in most of the documentation examples for this service that include authentication. If you're writing authentication code using `DefaultAzureCredential` with version 1.3.0 of the `Azure.Identity` library and seeing this error message, this issue affects you. | It's likely a result of some configuration issue with the `Azure.Identity` library and `DefaultAzureCredential`, its authentication class. This class is a wrapper containing several credential types that are tried in order. The issue may occur when the authentication flow reaches the `SharedTokenCacheCredential` type. | One strategy to resolve this is to exclude `SharedTokenCacheCredential` from your credential, as described in this [DefaultAzureCredential issue](https://github.com/Azure/azure-sdk/issues/1970) that is currently open against `Azure.Identity`. You can exclude `SharedTokenCacheCredential` from your credential by instantiating the `DefaultAzureCredential` class using the following optional parameter: `new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });`<br>Another option is to change your application to use an earlier version of `Azure.Identity`, such as [version 1.2.3](https://www.nuget.org/packages/Azure.Identity/1.2.3). Using an earlier version has no functional impact to Azure Digital Twins, which makes it an accepted solution. |
 
+## az dt commands fail in Azure CLI version 2.70.0
+
+**Issue description:** CLI commands from the `az dt` command set fail in version 2.70.0 of the Azure CLI (this is not the latest Azure CLI version). The error message ends in *AttributeError: 'CredentialAdaptor' object has no attribute 'signed_session'*.
+
+| Does this affect me? | Cause | Resolution |
+| --- | --- | --- |
+| If you're using a local Azure CLI that's on version 2.70.0 of the Azure CLI, this affects all `az dt` CLI commands. You can check your CLI version with the `az version` command. <br>This issue doesn't affect Cloud Shell users, because the Cloud Shell always has the latest CLI version. | This is a [known issue](https://github.com/Azure/azure-cli/issues/31042) with version 2.70.0 of the Azure CLI. | Use the `az upgrade` command to upgrade your CLI installation to the latest version. |
+
 ## Next steps
 
 Read more about security and permissions on Azure Digital Twins:
diff --git a/articles/digital-twins/tutorial-command-line-cli.md b/articles/digital-twins/tutorial-command-line-cli.md
@@ -101,8 +101,6 @@ After designing models, you need to upload them to your Azure Digital Twins inst
     
     The output from each command will show information about the successfully uploaded model.
 
-    [!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
-
     >[!TIP]
     >You can also upload all models within a directory at the same time, by using the `--from-directory` option for the model create command. For more information, see [Optional parameters for az dt model create](/cli/azure/dt/model#az-dt-model-create-optional-parameters).
 
diff --git a/articles/digital-twins/tutorial-end-to-end.md b/articles/digital-twins/tutorial-end-to-end.md
@@ -186,7 +186,6 @@ The first setting gives the function app the **Azure Digital Twins Data Owner**
     ```azurecli-interactive	
     az dt role-assignment create --resource-group <your-resource-group> --dt-name <your-Azure-Digital-Twins-instance> --assignee "<principal-ID>" --role "Azure Digital Twins Data Owner"
     ```
-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]
 
 The result of this command is outputted information about the role assignment that you created. The function app now has permissions to access data in your Azure Digital Twins instance.
 

Original file line number	Diff line number	Diff line change
`@@ -53,8 +53,6 @@ You then need to create one twin using this model. Use the following command to`
`53`	`53`	`az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{"Temperature": 0.0}'`
`54`	`54`	```
`55`	`55`
`56`		`-[!INCLUDE [digital-twins-cli-issue](includes/digital-twins-cli-issue.md)]`
`57`		`-`
`58`	`56`	`When the twin is created successfully, the CLI output from the command should look something like this:`
`59`	`57`	```json
`60`	`58`	`{`