Skip to content

Commit b57deb1

Browse files
committed
Updates to install files, tocs and redirects.
1 parent 021d0f2 commit b57deb1

8 files changed

+133
-640
lines changed

.openpublishing.redirection.deployment-environments.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@
1414
"source_path_from_root": "/articles/deployment-environments/tutorial-create-and-configure-projects.md",
1515
"redirect_url": "/azure/deployment-environments/quickstart-create-and-configure-projects",
1616
"redirect_document_id": false
17+
},
18+
{
19+
"source_path_from_root": "/articles/deployment-environments/how-to-configure-use-cli.md",
20+
"redirect_url": "https://aka.ms/CLI-reference",
21+
"redirect_document_id": false
1722
}
1823
]
1924
}

.openpublishing.redirection.dev-box.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,11 @@
99
"source_path_from_root": "/articles/dev-box/quickstart-configure-dev-box-project.md",
1010
"redirect_url": "/azure/dev-box/quickstart-configure-dev-box-service",
1111
"redirect_document_id": false
12+
},
13+
{
14+
"source_path_from_root": "/articles/dev-box/cli-reference-subset.md",
15+
"redirect_url": "https://aka.ms/CLI-reference",
16+
"redirect_document_id": false
1217
}
1318
]
1419
}

articles/deployment-environments/how-to-configure-use-cli.md

Lines changed: 0 additions & 292 deletions
This file was deleted.
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
title: Install the Azure Deployment Environments Preview Azure CLI extension
3+
titleSuffix: Azure Deployment Environments Preview
4+
description: Learn how to install the Azure CLI and the Azure Deployment Environments Preview CLI extension so you can create Deployment Environments resources from the command line.
5+
services: deployment-environments
6+
ms.service: deployment-environments
7+
ms.topic: how-to
8+
ms.author: rosemalcolm
9+
author: RoseHJM
10+
ms.date: 03/19/2023
11+
Customer intent: As a dev infra admin, I want to install the Deployment Environments CLI extension so that I can create Deployment Environments resources from the command line.
12+
---
13+
14+
# Azure Deployment Environments Preview Azure CLI extension
15+
16+
In addition to the Azure admin portal and the developer portal, you can use the Deployment Environments Azure CLI extension to create resources. Azure Deployment Environments and Microsoft Dev Box use the same Azure CLI extension, which is called `devcenter`.
17+
18+
## Install the Deployment Environments CLI extension
19+
20+
To install the Deployment Environments Azure CLI extension, you first need to install the Azure CLI. The following steps show you how to install the Azure CLI, then the Deployment Environments CLI extension.
21+
22+
1. Download and install the [Azure CLI](/cli/azure/install-azure-cli).
23+
24+
1. Install the Deployment Environments CLI extension
25+
``` azurecli
26+
az extension add --name devcenter
27+
```
28+
1. Check that the `devcenter` extension is installed
29+
``` azurecli
30+
az extension list
31+
```
32+
### Update the Deployment Environments CLI extension
33+
You can update the Deployment Environments CLI extension if you already have it installed.
34+
35+
To check the version of the extension that's installed
36+
``` azurecli
37+
az extension --version
38+
```
39+
40+
To update a version of the extension that's installed
41+
``` azurecli
42+
az extension update --name devcenter
43+
```
44+
### Uninstall the Deployment Environments CLI extension
45+
46+
To uninstall the extension, use the following command
47+
```azurecli
48+
az extension remove --name devcenter
49+
```
50+
51+
## Get started with the Deployment Environments CLI extension
52+
53+
1. Sign in to Azure CLI with your work account.
54+
55+
```azurecli
56+
az login
57+
```
58+
59+
1. Set your default subscription to the subscription where you're creating your specific Deployment Environments resources.
60+
61+
```azurecli
62+
az account set --subscription {subscriptionId}
63+
```
64+
65+
1. Set default resource group. Setting a default resource group means you don't need to specify the resource group for each command.
66+
67+
```azurecli
68+
az configure --defaults group={resourceGroupName}
69+
```
70+
71+
1. Get Help for a command
72+
73+
```azurecli
74+
az devcenter admin --help
75+
```
76+
77+
## Next steps
78+
79+
For complete command listings, refer to the [Microsoft Deployment Environments and Azure Deployment Environments Azure CLI documentation](https://aka.ms/CLI-reference).

0 commit comments

Comments
 (0)