Merge pull request #260773 from cdpark/refresh-access-environments

Freshness pass 167585: Azure Deployment Environments -- CLI access environments

Author: denrea

articles/deployment-environments/how-to-create-access-environments.md

@@ -7,22 +7,22 @@ ms.author: rosemalcolm
 ms.service: deployment-environments
 ms.custom: ignite-2022, devx-track-azurecli, build-2023
 ms.topic: how-to
-ms.date: 10/06/2023
+ms.date: 12/07/2023
 ---
 
 # Create and access an environment by using the Azure CLI
 
-This article shows you how to create and access an [environment](concept-environments-key-concepts.md#environments) in an existing Azure Deployment Environments project.
+This guide explains how to create and access an [environment](concept-environments-key-concepts.md#environments) in an existing Azure Deployment Environments project by using the Azure CLI.
 
 ## Prerequisites
 
-- [Create and configure a dev center](quickstart-create-and-configure-devcenter.md).
-- [Create and configure a project](quickstart-create-and-configure-projects.md).
-- [Install the Azure CLI](/cli/azure/install-azure-cli).
+- [Install the Azure CLI extension for Azure Deployment Environments](how-to-install-devcenter-cli-extension.md)
+- [Create and configure a dev center by using the Azure CLI](how-to-create-configure-dev-center.md)
+- [Create and configure a project by using the Azure CLI](how-to-create-configure-projects.md)
 
 ## Create an environment
 
-Creating an environment automatically creates the required resources and a resource group to store them. The resource group name follows the pattern {projectName}-{environmentName}. You can view the resource group in the Azure portal.
+Creating an environment automatically creates the required resources and a resource group to store them. The resource group name follows the pattern `{projectName}-{environmentName}`. You can view the resource group in the Azure portal.
 
 Complete the following steps in the Azure CLI to create an environment and configure resources. You can view the outputs as defined in the specific Azure Resource Manager template (ARM template).
 
@@ -49,42 +49,42 @@ Complete the following steps in the Azure CLI to create an environment and confi
 1. Configure the default subscription as the subscription that contains the project:
 
    ```azurecli
-   az account set --subscription <name>
+   az account set --subscription <subscriptionName>
    ```
 
 1. Configure the default resource group as the resource group that contains the project:
 
    ```azurecli
-   az config set defaults.group=<name>
+   az config set defaults.group=<resourceGroupName>
    ```
 
 1. List the type of environments you can create in a specific project:
 
    ```azurecli
-   az devcenter dev environment-type list --dev-center <name> --project-name <name> -o table
+   az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table
    ```
 
 1. List the [environment definitions](concept-environments-key-concepts.md#environment-definitions) that are available to a specific project:
 
    ```azurecli
-   az devcenter dev environment-definition list --dev-center <name> --project-name <name> -o table
+   az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table
    ```
 
 1. Create an environment by using an *environment-definition* (an infrastructure as code template defined in the [environment.yaml](configure-environment-definition.md#add-a-new-environment-definition) file) from the list of available environment definitions:
 
    ```azurecli
-   az devcenter dev environment create --dev-center-name <devcenter-name>
-       --project-name <project-name> --environment-name <name> --environment-type <environment-type-name>
-       --environment-definition-name <environment-definition-name> --catalog-name <catalog-name>
+   az devcenter dev environment create --dev-center-name <devcenterName>
+       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
+       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
    ```
 
     If the specific *environment-definition* requires any parameters, use `--parameters` and provide the parameters as a JSON string or a JSON file. For example:
 
    ```json
    $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
-   az devcenter dev environment create --dev-center-name <devcenter-name>
-       --project-name <project-name> --environment-name <name> --environment-type <environment-type-name>
-       --environment-definition-name <environment-definition-name> --catalog-name <catalog-name>
+   az devcenter dev environment create --dev-center-name <devcenterName>
+       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
+       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
        --parameters $params
    ```
 
@@ -105,14 +105,14 @@ Message: The environment resource was not found.
 
 To resolve the issue, assign the correct permissions: [Give access to the development team](quickstart-create-and-configure-projects.md#give-access-to-the-development-team).
 
-### Access an environment
+## Access an environment
 
 To access an environment:
 
 1. List existing environments that are available in a specific project:
 
    ```azurecli
-    az devcenter dev environment list --dev-center <devcenter-name> --project-name <project-name>
+    az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
    ```
 
 1. View the access endpoints to various resources as defined in the ARM template outputs.
@@ -121,17 +121,17 @@ To access an environment:
 ### Deploy an environment
 
 ```azurecli
-az devcenter dev environment deploy-action --action-id "deploy" --dev-center-name <devcenter-name> \
-    -g <resource-group-name> --project-name <project-name> --environment-name <environment-name> --parameters <parameters-json-string>
+az devcenter dev environment deploy-action --action-id "deploy" --dev-center-name <devcenterName> \
+    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>
 ```
 
 ### Delete an environment
 
 ```azurecli
-az devcenter dev environment delete --dev-center-name <devcenter-name>  --project-name <project-name> --environment-name <environment-name> --user-id "me"
+az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"
 ```
 
-## Next steps
+## Related content
 
-- Learn how to [add and configure a catalog](how-to-configure-catalog.md).
-- Learn how to [add and configure an environment definition](configure-environment-definition.md).
+- [Add and configure a catalog from GitHub or Azure DevOps](how-to-configure-catalog.md)
+- [Add and configure an environment definition](configure-environment-definition.md)