Update links

baanders · baanders · commit cf724ffdfbd8 · 2025-03-17T13:11:57.000-07:00
diff --git a/articles/digital-twins/concepts-cli.md b/articles/digital-twins/concepts-cli.md
@@ -30,7 +30,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!INCLUDE [digital-twins-cli-issue](../../includes/digital-twins-cli-issue.md)]
 
 ## Uses (deploy and validate)
 
diff --git a/articles/digital-twins/how-to-create-app-registration.md b/articles/digital-twins/how-to-create-app-registration.md
@@ -19,7 +19,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!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.
 
@@ -242,7 +242,7 @@ The app registration should show up in the list along with the role you assigned
 
 # [CLI](#tab/cli)
 
-[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
+[!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.
 
diff --git a/articles/digital-twins/how-to-create-data-history-connection.md b/articles/digital-twins/how-to-create-data-history-connection.md
@@ -171,7 +171,7 @@ This command also creates three tables in your Azure Data Explorer database to s
 
 # [CLI](#tab/cli) 
 
-[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
+[!INCLUDE [digital-twins-cli-issue](../../includes/digital-twins-cli-issue.md)]
 
 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
@@ -20,7 +20,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!INCLUDE [digital-twins-cli-issue](../../includes/digital-twins-cli-issue.md)]
 
 ## Prerequisites
 
@@ -88,7 +88,7 @@ Now the Event Grid topic, event hub, or Service Bus topic is available as an end
 
 # [CLI](#tab/cli) 
 
-[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
+[!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.
 
diff --git a/articles/digital-twins/how-to-create-routes.md b/articles/digital-twins/how-to-create-routes.md
@@ -37,7 +37,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!INCLUDE [digital-twins-cli-issue](../../includes/digital-twins-cli-issue.md)]
 
 ## Create an event route
 
@@ -82,7 +82,7 @@ When finished, select the **Save** button to create your event route.
 
 # [CLI](#tab/cli2)
 
-[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
+[!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. 
 
diff --git a/articles/digital-twins/how-to-enable-private-link.md b/articles/digital-twins/how-to-enable-private-link.md
@@ -168,7 +168,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!INCLUDE [digital-twins-cli-issue](../../includes/digital-twins-cli-issue.md)]
 
 ### Get more Private Link information
 
@@ -202,7 +202,7 @@ To disable or enable public network access in the [Azure portal](https://portal.
 
 # [CLI](#tab/cli-2)
 
-[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
+[!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)).
 
diff --git a/articles/digital-twins/how-to-ingest-iot-hub-data.md b/articles/digital-twins/how-to-ingest-iot-hub-data.md
@@ -57,7 +57,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!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,7 +44,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!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.
 
diff --git a/articles/digital-twins/troubleshoot-error-403-digital-twins.md b/articles/digital-twins/troubleshoot-error-403-digital-twins.md
@@ -54,7 +54,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!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).
 
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,7 +54,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!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).
 
diff --git a/articles/digital-twins/troubleshoot-error-cli-parse.md b/articles/digital-twins/troubleshoot-error-cli-parse.md
@@ -13,7 +13,7 @@ ms.date: 03/31/2022
 
 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.md](digital-twins-cli-issue.md)]
+[!INCLUDE [digital-twins-cli-issue](../../includes/digital-twins-cli-issue.md)]
 
 ## Symptoms
 
diff --git a/articles/digital-twins/tutorial-command-line-cli.md b/articles/digital-twins/tutorial-command-line-cli.md
@@ -101,7 +101,7 @@ 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.md](digital-twins-cli-issue.md)]
+    [!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,7 @@ 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.md](digital-twins-cli-issue.md)]
+[!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.
 
diff --git a/includes/digital-twins-cli-issue.md b/includes/digital-twins-cli-issue.md
@@ -9,4 +9,4 @@ ms.date: 3/17/2025
 ---
 
 >[!NOTE]
-> Due to a [known issue](../articles/digital-twins/troubleshoot-known-issues.md#az-dt-commands-fail-in-azure-cli-version-270) with the Azure CLI, `az dt` commands that are run in version 2.70 of the Azure CLI fail with an *AttributeError* message. To bypass this issue, use a [local CLI installation](https://learn.microsoft.com/cli/azure/install-azure-cli) and downgrade your CLI to version 2.69.
+> Due to a [known issue](../articles/digital-twins/troubleshoot-known-issues.md#az-dt-commands-fail-in-azure-cli-version-270) with the Azure CLI, `az dt` commands that are run in version 2.70 of the Azure CLI fail with an *AttributeError* message. To bypass this issue, use a [local CLI installation](/cli/azure/install-azure-cli) and downgrade your CLI to version 2.69.
diff --git a/includes/digital-twins-cli.md b/includes/digital-twins-cli.md
@@ -9,7 +9,7 @@ ms.author: baanders
 
 ### Set up CLI session
 
-[!INCLUDE [digital-twins-cli-issue.md](digital-twins-cli-issue.md)]
+[!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:
 
