@@ -32,88 +32,88 @@ Install the Azure CLI and the Dev Box CLI extension as described here: [Microsof
32
32
#### Create an image definition that meets all requirements
33
33
34
34
``` 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
41
41
```
42
42
43
43
#### Attach a Gallery to the DevCenter
44
44
45
45
``` 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}"
49
49
```
50
50
51
51
### DevCenter
52
52
53
53
#### Create a DevCenter
54
54
55
55
``` 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}
60
60
```
61
61
62
62
### Project
63
63
64
64
#### Create a Project
65
65
66
66
``` 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}
71
71
```
72
72
73
73
#### Delete a Project
74
74
75
75
``` 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}
79
79
```
80
80
81
81
### Network Connection
82
82
83
83
#### Create a native AADJ Network Connection
84
84
85
85
``` 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"
90
90
```
91
91
92
92
#### Create a hybrid AADJ Network Connection
93
93
94
94
``` 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"
100
100
```
101
101
102
102
#### Attach a Network Connection to the DevCenter
103
103
104
104
``` 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
108
108
```
109
109
110
110
### Dev Box Definition
111
111
112
112
#### List Dev Box Definitions in a DevCenter
113
113
114
114
``` 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"
117
117
```
118
118
119
119
#### List skus available in your subscription
@@ -124,18 +124,18 @@ az devcenter admin sku list
124
124
#### Create a Dev Box Definition with a marketplace image
125
125
126
126
``` 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"
131
131
```
132
132
133
133
#### Create a Dev Box Definition with a custom image
134
134
135
135
``` 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"
139
139
--os-storage-type "ssd_1024gb" --sku name=general_a_8c32gb_v1
140
140
```
141
141
@@ -144,128 +144,128 @@ az devcenter admin devbox-definition create -g demo-rg `
144
144
#### Create a Pool
145
145
146
146
``` 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
152
152
```
153
153
154
154
#### Get Pool
155
155
156
156
``` 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}"
159
159
```
160
160
161
161
#### List Pools
162
162
163
163
``` 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}
166
166
```
167
167
168
168
#### Update Pool
169
169
170
170
Update Network Connection
171
171
172
172
``` 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}"
177
177
--network-connection-name {networkConnectionName}
178
178
```
179
179
180
180
Update Dev Box Definition
181
181
182
182
``` 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}
188
188
```
189
189
190
190
#### Delete Pool
191
191
192
192
``` 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}"
197
197
```
198
198
199
199
### Dev Boxes
200
200
201
201
#### List available Projects
202
202
203
203
``` azurecli
204
- az devcenter dev project list `
204
+ az devcenter dev project list
205
205
--devcenter {devCenterName}
206
206
```
207
207
208
208
#### List Pools in a Project
209
209
210
210
``` 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}
214
214
```
215
215
216
216
#### Create a dev box
217
217
218
218
``` 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}
224
224
```
225
225
226
226
#### Get web connection URL for a dev box
227
227
228
228
``` 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}
232
232
--user-id "me"
233
- -n {devBoxName} `
233
+ -n {devBoxName}
234
234
```
235
235
236
236
#### List your Dev Boxes
237
237
238
238
``` azurecli
239
- az devcenter dev dev-box list --devcenter {devCenterName} `
239
+ az devcenter dev dev-box list --devcenter {devCenterName}
240
240
```
241
241
242
242
#### View details of a Dev Box
243
243
244
244
``` 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}
248
248
-n {devBoxName}
249
249
```
250
250
251
251
#### Stop a Dev Box
252
252
253
253
``` 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}
259
259
```
260
260
261
261
#### Start a Dev Box
262
262
263
263
``` 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}
269
269
```
270
270
271
271
## Next steps
0 commit comments