Skip to content

Commit cec408e

Browse files
Merge pull request #227695 from RoseHJM/mdb-cli-ref-update
MDB - updates to CLI reference doc
2 parents 50e488d + 81ace0e commit cec408e

File tree

1 file changed

+90
-90
lines changed

1 file changed

+90
-90
lines changed

articles/dev-box/cli-reference-subset.md

Lines changed: 90 additions & 90 deletions
Original file line numberDiff line numberDiff line change
@@ -32,88 +32,88 @@ Install the Azure CLI and the Dev Box CLI extension as described here: [Microsof
3232
#### Create an image definition that meets all requirements
3333

3434
```azurecli
35-
az sig image-definition create --resource-group {resourceGroupName} `
36-
--gallery-name {galleryName} --gallery-image-definition {definitionName} `
37-
--publisher {publisherName} --offer {offerName} --sku {skuName} `
38-
--os-type windows --os-state Generalized `
39-
--hyper-v-generation v2 `
40-
--features SecurityType=TrustedLaunch `
35+
az sig image-definition create --resource-group {resourceGroupName}
36+
--gallery-name {galleryName} --gallery-image-definition {definitionName}
37+
--publisher {publisherName} --offer {offerName} --sku {skuName}
38+
--os-type windows --os-state Generalized
39+
--hyper-v-generation v2
40+
--features SecurityType=TrustedLaunch
4141
```
4242

4343
#### Attach a Gallery to the DevCenter
4444

4545
```azurecli
46-
az devcenter admin gallery create -g demo-rg `
47-
--devcenter-name contoso-devcenter -n SharedGallery `
48-
--gallery-resource-id "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{computeGalleryName}" `
46+
az devcenter admin gallery create -g demo-rg
47+
--devcenter-name contoso-devcenter -n SharedGallery
48+
--gallery-resource-id "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{computeGalleryName}"
4949
```
5050

5151
### DevCenter
5252

5353
#### Create a DevCenter
5454

5555
```azurecli
56-
az devcenter admin devcenter create -g demo-rg `
57-
-n contoso-devcenter --identity-type UserAssigned `
58-
--user-assigned-identity ` "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{managedIdentityName}" `
59-
--location {regionName} `
56+
az devcenter admin devcenter create -g demo-rg
57+
-n contoso-devcenter --identity-type UserAssigned
58+
--user-assigned-identity "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{managedIdentityName}"
59+
--location {regionName}
6060
```
6161

6262
### Project
6363

6464
#### Create a Project
6565

6666
```azurecli
67-
az devcenter admin project create -g demo-rg `
68-
-n ContosoProject `
69-
--description "project description" `
70-
--devcenter-id /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName} `
67+
az devcenter admin project create -g demo-rg
68+
-n ContosoProject
69+
--description "project description"
70+
--devcenter-id /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}
7171
```
7272

7373
#### Delete a Project
7474

7575
```azurecli
76-
az devcenter admin project delete `
77-
-g {resourceGroupName} `
78-
--project {projectName} `
76+
az devcenter admin project delete
77+
-g {resourceGroupName}
78+
--project {projectName}
7979
```
8080

8181
### Network Connection
8282

8383
#### Create a native AADJ Network Connection
8484

8585
```azurecli
86-
az devcenter admin network-connection create --location "centralus" `
87-
--domain-join-type "AzureADJoin" `
88-
--subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default" `
89-
--name "{networkConnectionName}" --resource-group "rg1" `
86+
az devcenter admin network-connection create --location "centralus"
87+
--domain-join-type "AzureADJoin"
88+
--subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default"
89+
--name "{networkConnectionName}" --resource-group "rg1"
9090
```
9191

9292
#### Create a hybrid AADJ Network Connection
9393

9494
```azurecli
95-
az devcenter admin network-connection create --location "centralus" `
96-
--domain-join-type "HybridAzureADJoin" --domain-name "mydomaincontroller.local" `
97-
--domain-password "Password value for user" --domain-username "[email protected]" `
98-
--subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default" `
99-
--name "{networkConnectionName}" --resource-group "rg1" `
95+
az devcenter admin network-connection create --location "centralus"
96+
--domain-join-type "HybridAzureADJoin" --domain-name "mydomaincontroller.local"
97+
--domain-password "Password value for user" --domain-username "[email protected]"
98+
--subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default"
99+
--name "{networkConnectionName}" --resource-group "rg1"
100100
```
101101

102102
#### Attach a Network Connection to the DevCenter
103103

104104
```azurecli
105-
az devcenter admin attached-network create --attached-network-connection-name westus3network `
106-
--devcenter-name contoso-devcenter -g demo-rg `
107-
--network-connection-id /subscriptions/f141e9f2-4778-45a4-9aa0-8b31e6469454/resourceGroups/demo-rg/providers/Microsoft.DevCenter/networkConnections/netset99 `
105+
az devcenter admin attached-network create --attached-network-connection-name westus3network
106+
--devcenter-name contoso-devcenter -g demo-rg
107+
--network-connection-id /subscriptions/f141e9f2-4778-45a4-9aa0-8b31e6469454/resourceGroups/demo-rg/providers/Microsoft.DevCenter/networkConnections/netset99
108108
```
109109

110110
### Dev Box Definition
111111

112112
#### List Dev Box Definitions in a DevCenter
113113

114114
```azurecli
115-
az devcenter admin devbox-definition list `
116-
--devcenter-name "Contoso" --resource-group "rg1" `
115+
az devcenter admin devbox-definition list
116+
--devcenter-name "Contoso" --resource-group "rg1"
117117
```
118118

119119
#### List skus available in your subscription
@@ -124,18 +124,18 @@ az devcenter admin sku list
124124
#### Create a Dev Box Definition with a marketplace image
125125

126126
```azurecli
127-
az devcenter admin devbox-definition create -g demo-rg `
128-
--devcenter-name contoso-devcenter -n BaseImageDefinition `
129-
--image-reference id="/subscriptions/{subscriptionId}/resourceGroups/demo-rg/providers/Microsoft.DevCenter/devcenters/contoso-devcenter/galleries/Default/images/MicrosoftWindowsDesktop_windows-ent-cpc_win11-21h2-ent-cpc-m365" `
130-
--sku name="general_a_8c32gb_v1" `
127+
az devcenter admin devbox-definition create -g demo-rg
128+
--devcenter-name contoso-devcenter -n BaseImageDefinition
129+
--image-reference id="/subscriptions/{subscriptionId}/resourceGroups/demo-rg/providers/Microsoft.DevCenter/devcenters/contoso-devcenter/galleries/Default/images/MicrosoftWindowsDesktop_windows-ent-cpc_win11-21h2-ent-cpc-m365"
130+
--sku name="general_a_8c32gb_v1"
131131
```
132132

133133
#### Create a Dev Box Definition with a custom image
134134

135135
```azurecli
136-
az devcenter admin devbox-definition create -g demo-rg `
137-
--devcenter-name contoso-devcenter -n CustomDefinition `
138-
--image-reference id="/subscriptions/{subscriptionId}/resourceGroups/demo-rg/providers/Microsoft.DevCenter/devcenters/contoso-devcenter/galleries/SharedGallery/images/CustomImageName" `
136+
az devcenter admin devbox-definition create -g demo-rg
137+
--devcenter-name contoso-devcenter -n CustomDefinition
138+
--image-reference id="/subscriptions/{subscriptionId}/resourceGroups/demo-rg/providers/Microsoft.DevCenter/devcenters/contoso-devcenter/galleries/SharedGallery/images/CustomImageName"
139139
--os-storage-type "ssd_1024gb" --sku name=general_a_8c32gb_v1
140140
```
141141

@@ -144,128 +144,128 @@ az devcenter admin devbox-definition create -g demo-rg `
144144
#### Create a Pool
145145

146146
```azurecli
147-
az devcenter admin pool create -g demo-rg `
148-
--project-name ContosoProject -n MarketplacePool `
149-
--devbox-definition-name Definition `
150-
--network-connection-name westus3network `
151-
--license-type Windows_Client --local-administrator Enabled `
147+
az devcenter admin pool create -g demo-rg
148+
--project-name ContosoProject -n MarketplacePool
149+
--devbox-definition-name Definition
150+
--network-connection-name westus3network
151+
--license-type Windows_Client --local-administrator Enabled
152152
```
153153

154154
#### Get Pool
155155

156156
```azurecli
157-
az devcenter admin pool show --resource-group "{resourceGroupName}" `
158-
--project-name {projectName} --name "{poolName}" `
157+
az devcenter admin pool show --resource-group "{resourceGroupName}"
158+
--project-name {projectName} --name "{poolName}"
159159
```
160160

161161
#### List Pools
162162

163163
```azurecli
164-
az devcenter admin pool list --resource-group "{resourceGroupName}" `
165-
--project-name {projectName} `
164+
az devcenter admin pool list --resource-group "{resourceGroupName}"
165+
--project-name {projectName}
166166
```
167167

168168
#### Update Pool
169169

170170
Update Network Connection
171171

172172
```azurecli
173-
az devcenter admin pool update `
174-
--resource-group "{resourceGroupName}" `
175-
--project-name {projectName} `
176-
--name "{poolName}" `
173+
az devcenter admin pool update
174+
--resource-group "{resourceGroupName}"
175+
--project-name {projectName}
176+
--name "{poolName}"
177177
--network-connection-name {networkConnectionName}
178178
```
179179

180180
Update Dev Box Definition
181181

182182
```azurecli
183-
az devcenter admin pool update `
184-
--resource-group "{resourceGroupName}" `
185-
--project-name {projectName} `
186-
--name "{poolName}" `
187-
--devbox-definition-name {devBoxDefinitionName} `
183+
az devcenter admin pool update
184+
--resource-group "{resourceGroupName}"
185+
--project-name {projectName}
186+
--name "{poolName}"
187+
--devbox-definition-name {devBoxDefinitionName}
188188
```
189189

190190
#### Delete Pool
191191

192192
```azurecli
193-
az devcenter admin pool delete `
194-
--resource-group "{resourceGroupName}" `
195-
--project-name "{projectName}" `
196-
--name "{poolName}" `
193+
az devcenter admin pool delete
194+
--resource-group "{resourceGroupName}"
195+
--project-name "{projectName}"
196+
--name "{poolName}"
197197
```
198198

199199
### Dev Boxes
200200

201201
#### List available Projects
202202

203203
```azurecli
204-
az devcenter dev project list `
204+
az devcenter dev project list
205205
--devcenter {devCenterName}
206206
```
207207

208208
#### List Pools in a Project
209209

210210
```azurecli
211-
az devcenter dev pool list `
212-
--devcenter {devCenterName} `
213-
--project-name {ProjectName} `
211+
az devcenter dev pool list
212+
--devcenter {devCenterName}
213+
--project-name {ProjectName}
214214
```
215215

216216
#### Create a dev box
217217

218218
```azurecli
219-
az devcenter dev dev-box create `
220-
--devcenter {devCenterName} `
221-
--project-name {projectName} `
222-
--pool-name {poolName} `
223-
-n {devBoxName} `
219+
az devcenter dev dev-box create
220+
--devcenter {devCenterName}
221+
--project-name {projectName}
222+
--pool-name {poolName}
223+
-n {devBoxName}
224224
```
225225

226226
#### Get web connection URL for a dev box
227227

228228
```azurecli
229-
az devcenter dev dev-box show-remote-connection `
230-
--devcenter {devCenterName} `
231-
--project-name {projectName} `
229+
az devcenter dev dev-box show-remote-connection
230+
--devcenter {devCenterName}
231+
--project-name {projectName}
232232
--user-id "me"
233-
-n {devBoxName} `
233+
-n {devBoxName}
234234
```
235235

236236
#### List your Dev Boxes
237237

238238
```azurecli
239-
az devcenter dev dev-box list --devcenter {devCenterName} `
239+
az devcenter dev dev-box list --devcenter {devCenterName}
240240
```
241241

242242
#### View details of a Dev Box
243243

244244
```azurecli
245-
az devcenter dev dev-box show `
246-
--devcenter {devCenterName} `
247-
--project-name {projectName} `
245+
az devcenter dev dev-box show
246+
--devcenter {devCenterName}
247+
--project-name {projectName}
248248
-n {devBoxName}
249249
```
250250

251251
#### Stop a Dev Box
252252

253253
```azurecli
254-
az devcenter dev dev-box stop `
255-
--devcenter {devCenterName} `
256-
--project-name {projectName} `
257-
--user-id "me" `
258-
-n {devBoxName} `
254+
az devcenter dev dev-box stop
255+
--devcenter {devCenterName}
256+
--project-name {projectName}
257+
--user-id "me"
258+
-n {devBoxName}
259259
```
260260

261261
#### Start a Dev Box
262262

263263
```azurecli
264-
az devcenter dev dev-box start `
265-
--devcenter {devCenterName} `
266-
--project-name {projectName} `
267-
--user-id "me" `
268-
-n {devBoxName} `
264+
az devcenter dev dev-box start
265+
--devcenter {devCenterName}
266+
--project-name {projectName}
267+
--user-id "me"
268+
-n {devBoxName}
269269
```
270270

271271
## Next steps

0 commit comments

Comments
 (0)