You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -37,18 +37,23 @@ Here are the Azure-managed extensions:
37
37
-[Remote Support Arc extension](../manage/remote-support-arc-extension.md)
38
38
39
39
## Install an extension
40
+
40
41
### [Azure portal](#tab/azureportal)
42
+
41
43
You can install extensions from the **Capabilities** tab for your Azure Local Arc-enabled servers as shown in the screenshot. You can use the capabilities tab to install most extensions.
42
44
43
45
:::image type="content" source="media/arc-extension-management/arc-extension-overview.png" alt-text="Screenshot of the Capabilities tab and options in the Azure portal." lightbox="media/arc-extension-management/arc-extension-overview.png":::
44
46
45
47
When you install an extension in the Azure portal, it's a cluster-aware operation. The extension is installed on all nodes of the system. If you add more nodes to your system, all the extensions installed on your system are automatically added to the new servers.
46
48
47
49
### [Azure CLI](#tab/azurecli)
50
+
48
51
Azure CLI is available to install in Windows, macOS, and Linux environments. It can also be run in Azure Cloud Shell. For more information, refer [Quickstart for Azure Cloud Shell](/azure/cloud-shell/quickstart).
49
52
50
53
Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to install an extension following these steps:
54
+
51
55
1. Set up parameters from your subscription, resource group, and clusters
56
+
52
57
```azurecli
53
58
subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
54
59
resourceGroup="hcicluster-rg" # Replace with your resource group name
@@ -59,6 +64,7 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to install an
59
64
```
60
65
61
66
1. To install the Windows Admin Center extension on all the systems under the resource group, run the following command:
67
+
62
68
```azurecli
63
69
extensionName="AdminCenter"
64
70
extensionType="AdminCenter"
@@ -88,6 +94,7 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to install an
88
94
```
89
95
90
96
1. To install the Azure Monitor Agent extension on all the systems under the resource group, run the following command:
97
+
91
98
```azurecli
92
99
extensionName="AzureMonitorWindowsAgent"
93
100
extensionType="AzureMonitorWindowsAgent"
@@ -108,6 +115,7 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to install an
108
115
```
109
116
110
117
1. To install the Azure Site Recovery extension on all the systems under the resource group, run the following command:
118
+
111
119
```azurecli
112
120
asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
113
121
asrResourceGroup="asr-rg" # Replace with your ASR resource group
@@ -140,19 +148,23 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to install an
140
148
```
141
149
142
150
### [Azure PowerShell](#tab/azurepowershell)
151
+
143
152
Azure PowerShell can be run in Azure Cloud Shell. This document details how to use PowerShell in Azure Cloud Shell. For more information, refer [Quickstart for Azure Cloud Shell](/azure/cloud-shell/quickstart).
144
153
145
154
Launch [Azure Cloud Shell](https://shell.azure.com/) and use PowerShell to install an extension following these steps:
146
155
147
156
1. Set up parameters from your subscription, resource group, and clusters:
157
+
148
158
```powershell
149
159
$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
150
160
$resourceGroup = "hcicluster-rg" # Replace with your resource group name
1. To install the Windows Admin Center extension on all the systems under the resource group, run the following command:
167
+
156
168
```powershell
157
169
$extensionName = "AdminCenter"
158
170
$extensionType = "AdminCenter"
@@ -189,6 +201,7 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use PowerShell to insta
189
201
```
190
202
191
203
1. To install the Azure Monitor Agent extension on all the systems under the resource group, run the following command:
204
+
192
205
```powershell
193
206
$extensionName = "AzureMonitorWindowsAgent"
194
207
$extensionType = "AzureMonitorWindowsAgent"
@@ -210,6 +223,7 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use PowerShell to insta
210
223
```
211
224
212
225
1. To install the Azure Site Recovery extension on all the systems under the resource group, create a JSON parameter file and then run the following command:
226
+
213
227
```powershell
214
228
$settings = @{
215
229
SubscriptionId = "<Replace with your Subscription Id>"
@@ -247,17 +261,21 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use PowerShell to insta
247
261
---
248
262
249
263
## Check the extension status
264
+
250
265
### [Azure portal](#tab/azureportal)
266
+
251
267
You can check the status of an extension on each server from the **Extensions** page by viewing the **status** column of the grid.
252
268
253
269
:::image type="content" source="media/arc-extension-management/arc-extension-status-view.png" alt-text="Screenshot of the different extension statuses in the Azure portal." lightbox="media/arc-extension-management/arc-extension-status-view.png":::
254
270
255
271
### [Azure CLI](#tab/azurecli)
272
+
256
273
Azure CLI is available to install in Windows, macOS, and Linux environments. It can also be run in Azure Cloud Shell. For more information, refer [Quickstart for Azure Cloud Shell](/azure/cloud-shell/quickstart).
257
274
258
275
Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to check the status of an extension following these steps:
259
276
260
277
1. Set up parameters from your subscription, resource group, cluster name, and extension name
278
+
261
279
```azurecli
262
280
subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
263
281
resourceGroup="hcicluster-rg" # Replace with your resource group name
@@ -269,7 +287,7 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to check the s
269
287
270
288
1. To list all the extensions on a system, run the following command:
271
289
272
-
```azurecli
290
+
```azurecli
273
291
az stack-hci extension list \
274
292
--arc-setting-name "default" \
275
293
--cluster-name "${clusterName}" \
@@ -278,20 +296,24 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use Bash to check the s
278
296
```
279
297
280
298
1. To filter out a specific extension like `AzureMonitorWindowsAgent`, run the following command:
Azure PowerShell can be run in Azure Cloud Shell. This document details how to use PowerShell in Azure Cloud Shell. For more information, refer [Quickstart for Azure Cloud Shell](/azure/cloud-shell/quickstart).
291
312
292
313
Launch [Azure Cloud Shell](https://shell.azure.com/) and use PowerShell to check the status of an extension following these steps:
293
314
294
315
1. Set up parameters from your subscription, resource group, and cluster name
316
+
295
317
```powershell
296
318
$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
297
319
$resourceGroup = "hcicluster-rg" # Replace with your resource group name
@@ -300,8 +322,8 @@ Launch [Azure Cloud Shell](https://shell.azure.com/) and use PowerShell to check
1. To list all the extensions on a system, run the following command:
326
+
305
327
```powershell
306
328
foreach ($cluster in $clusters) {
307
329
$clusterName = ${cluster}.Name
@@ -341,6 +363,7 @@ To enable an automatic upgrade, navigate to the **Extensions** page and perform
341
363
:::image type="content" source="media/arc-extension-management/arc-extension-enable-auto-upgrade-2.png" alt-text="Screenshot of the notification to enable auto upgrade in the Azure portal." lightbox="media/arc-extension-management/arc-extension-enable-auto-upgrade-2.png":::
342
364
343
365
### [Azure CLI](#tab/azurecli)
366
+
344
367
To install and enable auto upgrade for a specific extension like `AzureMonitorWindowsAgent`, run the following command:
345
368
346
369
```azurecli
@@ -362,6 +385,7 @@ az stack-hci extension create \
362
385
```
363
386
364
387
### [Azure PowerShell](#tab/azurepowershell)
388
+
365
389
To install and enable auto upgrade for a specific extension like `AzureMonitorWindowsAgent`, run the following command:
366
390
367
391
```powershell
@@ -381,6 +405,7 @@ New-AzStackHciExtension `
381
405
-ExtensionParameterType "${extensionType}" `
382
406
-ExtensionParameterEnableAutomaticUpgrade
383
407
```
408
+
384
409
---
385
410
386
411
### Manual extension upgrade via the Azure portal
@@ -404,7 +429,6 @@ To manually upgrade an extension, follow these steps:
404
429
405
430
3. Choose the latest version and select **Save**.
406
431
407
-
408
432
#### Extensions not supported for manual upgrade
409
433
410
434
Updating Azure Arc extensions manually from the Azure Local Machine page via the Azure portal may result in issues during deployment. The extensions that shouldn't be updated manually are: `AzureEdgeDeviceManagement`, `AzureEdgeLifecycleManager`, and `AzureEdgeAKVBackupForWindows` as shown in the figure.
@@ -451,6 +475,7 @@ If multiple extension upgrades are available for a node, they might be batched t
451
475
## Uninstall an extension
452
476
453
477
### [Azure portal](#tab/azureportal)
478
+
454
479
If desired, you can uninstall some extensions from your Azure Local in the Azure portal. To uninstall an extension, use these steps:
455
480
456
481
1. Go to the **Extensions page**.
@@ -466,6 +491,7 @@ If desired, you can uninstall some extensions from your Azure Local in the Azure
466
491
### [Azure CLI](#tab/azurecli)
467
492
468
493
To remove a specific extension like `AzureMonitorWindowsAgent`, run the following command:
494
+
469
495
```azurecli
470
496
extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
471
497
resourceGroup="hcicluster-rg" # Replace with your resource group name
@@ -479,11 +505,12 @@ az stack-hci extension delete \
479
505
```
480
506
481
507
### [Azure PowerShell](#tab/azurepowershell)
508
+
482
509
To remove a specific extension like `AzureMonitorWindowsAgent`, run the following command:
510
+
483
511
```powershell
484
512
$clusterName = "HCICluster" # Replace with your cluster name
485
513
$resourceGroup = "hcicluster-rg" # Replace with your resource group name
0 commit comments