Skip to content

Commit 7dd99f3

Browse files
authored
Merge pull request #8112 from paulth1/windows-admin-center-deployment
[AQ] edit pass: Windows admin center deployment
2 parents 2642ab6 + 620f532 commit 7dd99f3

4 files changed

Lines changed: 153 additions & 169 deletions

File tree

WindowsServerDocs/manage/windows-admin-center/deploy/high-availability.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Deploy Windows Admin Center with High Availability
3-
description: Deploy Windows Admin Center with High Availability (Project Honolulu)
3+
description: Deploy Windows Admin Center with high availability (Project Honolulu).
44
ms.topic: install-set-up-deploy
55
author: davannaw-msft
66
ms.author: dawhite
@@ -9,44 +9,44 @@ ms.date: 06/23/2025
99

1010
# Deploy Windows Admin Center with high availability
1111

12-
You can deploy Windows Admin Center in a failover cluster to provide high availability for your Windows Admin Center gateway service. The solution provided is an active-passive solution, where only one instance of Windows Admin Center is active. If one of the nodes in the cluster fails, Windows Admin Center gracefully fails over to another node, letting you continue managing the servers in your environment seamlessly.
12+
You can deploy Windows Admin Center in a failover cluster to provide high availability for your Windows Admin Center gateway. This solution is active-passive, where only one instance of Windows Admin Center is active. If one of the nodes in the cluster fails, Windows Admin Center gracefully fails over to another node so that you can continue managing the servers in your environment seamlessly.
1313

14-
[Learn about other Windows Admin Center deployment options.](../plan/installation-options.md)
14+
Learn about [other Windows Admin Center deployment options](../plan/installation-options.md).
1515

1616
> [!IMPORTANT]
17-
> Direct upgrades from high availability deployments in Windows Admin Center versions 2311 and older to versions 2410 and newer are not supported due to architectural changes. To upgrade, you must uninstall and reinstall Windows Admin Center.
17+
> Windows Admin Center versions 2311 and older don't support direct upgrades from high-availability deployments to versions 2410 and newer because of architectural changes. To upgrade, you must uninstall and reinstall Windows Admin Center.
1818
1919
## Prerequisites
2020

21-
- High-availability deployment scripts from the [Windows Admin Center HA Script zip file](https://aka.ms/WACHAScript). Download the .zip file containing the scripts to your local machine, and then copy the deployment script as needed based on the guidance in this article.
22-
- A failover cluster of two or more nodes running on Windows Server 2016 or later. [Learn more about deploying a Failover Cluster](../../../failover-clustering/failover-clustering-overview.md).
23-
- A cluster shared volume (CSV) for Windows Admin Center to store persistent data that all the nodes in the cluster can access. 10 GB is sufficient for your CSV.
21+
- High-availability deployment scripts from the [Windows Admin Center HA Script zip file](https://aka.ms/WACHAScript). Download the .zip file containing the scripts to your local machine. Then copy the deployment script as needed based on the guidance in this article.
22+
- A failover cluster of two or more nodes running on Windows Server 2016 or later. Learn more about [how to deploy a failover cluster](../../../failover-clustering/failover-clustering-overview.md).
23+
- A cluster shared volume (CSV) for Windows Admin Center to store persistent data that all the nodes in the cluster can access. Your CSV needs only 10 GB.
2424
- A certificate thumbprint from a certificate from a valid certificate authority (CA) with the private key installed on every node.
2525

2626
> [!NOTE]
2727
> The `Deploy-GatewayV2Ha.zip` file contains the following scripts:
28+
>
2829
> - `Deploy-GatewayV2Ha.Deploy.ps1`
2930
> - `Deploy-GatewayV2Ha.Validate.ps1`
3031
> - `Deploy-GatewayV2Ha.Inspect.ps1`
3132
> - `Deploy-GatewayV2Ha.Uninstall.ps1`
3233
3334
## Install Windows Admin Center on a failover cluster
3435

35-
1. Copy the `Deploy-GatewayV2Ha.Deploy.ps1` script to a node in your cluster. Download or copy the Windows Admin Center `.exe` to the same node.
36-
1. Connect to the node via RDP, go to the folder containing the script, and run the `Deploy-GatewayV2Ha.Deploy.ps1` script as an administrator with the following parameters:
37-
- `-clusterStorage`: the local path of the Cluster Shared Volume to store Windows Admin Center data.
38-
- `-clientAccessPoint`: choose a name that you use to access Windows Admin Center. For example, if you run the script with the parameter `-clientAccessPoint contosoWindowsAdminCenter`, you access the Windows Admin Center service by visiting `https://contosoWindowsAdminCenter.<domain>.com`.
36+
1. Copy the `Deploy-GatewayV2Ha.Deploy.ps1` script to a node in your cluster. Download or copy the Windows Admin Center `.exe` file to the same node.
37+
1. Connect to the node via Remote Desktop Protocol, go to the folder that contains the script, and run the `Deploy-GatewayV2Ha.Deploy.ps1` script as an administrator with the following parameters:
38+
- `-clusterStorage`: The local path of the CSV to store Windows Admin Center data.
39+
- `-clientAccessPoint`: The name that you use to access Windows Admin Center. For example, if you run the script with the parameter `-clientAccessPoint contosoWindowsAdminCenter`, you access the Windows Admin Center service by visiting `https://contosoWindowsAdminCenter.<domain>.com`.
3940
- `-staticAddress`: Optional. One or more static addresses for the cluster generic service.
4041
- `-InstallerPath`: The path for the Windows Admin Center `.exe` file.
41-
- `-CertificateThumbprint`: TLS certificate thumbprint present on every node.
42+
- `-CertificateThumbprint`: A Transport Layer Security certificate thumbprint present on every node.
4243
- `-generateSslCert`: Optional. If you don't want to provide a signed certificate, include this parameter flag to generate a self-signed certificate. The self-signed certificate expires in 60 days.
43-
- `-HttpsPort`: Optional. If you don't specify a port, the gateway service is deployed on port 443 (HTTPS). To use a different port, specify in this parameter. If you use a custom port besides 443, you access the Windows Admin Center by going to `https://\<clientAccessPoint\>:<port>`.
44+
- `-HttpsPort`: Optional. If you don't specify a port, the gateway service is deployed on port 443 (HTTPS). To use a different port, specify in this parameter. If you use a custom port instead of 443, you access the Windows Admin Center by going to `https://\<clientAccessPoint\>:<port>`.
4445

4546
> [!NOTE]
4647
> The `Deploy-GatewayV2Ha.Deploy.ps1` script supports `-WhatIf` and `-Verbose` parameters.
4748
48-
> [!IMPORTANT]
49-
> To perform further lifecycle operations on your high availability install, ensure all scripts from the `Deploy-GatewayV2Ha.zip` file are present on all nodes.
49+
To perform further lifecycle operations on your high-availability installation, ensure that all scripts from the `Deploy-GatewayV2Ha.zip` file are present on all nodes.
5050

5151
### Example
5252

@@ -61,9 +61,9 @@ $parameters = @{
6161
Deploy-GatewayV2Ha.Deploy @parameters
6262
```
6363

64-
## Update an existing high availability installation
64+
## Update an existing high-availability installation
6565

66-
Use the same `Deploy-GatewayV2Ha.Deploy.ps1` script to update your HA deployment, without losing your connection data.
66+
Use the same `Deploy-GatewayV2Ha.Deploy.ps1` script to update your high-availability deployment, without losing your connection data.
6767

6868
### Update to a new version of Windows Admin Center
6969

@@ -84,7 +84,7 @@ You can also update the certificate when you update the Windows Admin Center pla
8484

8585
### Update the certificate used by Windows Admin Center
8686

87-
You can update the certificate used by a HA deployment of Windows Admin Center at any time by using the `-UpdateCertificate` flag.
87+
You can update the certificate used by a high-availability deployment of Windows Admin Center at any time by using the `-UpdateCertificate` flag.
8888

8989
```powershell
9090
$parameters = @{
@@ -96,9 +96,9 @@ $parameters = @{
9696
Deploy-GatewayV2Ha.Deploy @parameters
9797
```
9898

99-
## Uninstall the high availability deployment
99+
## Uninstall the high-availability deployment
100100

101-
To uninstall the HA deployment of Windows Admin Center from your failover cluster, run the `Deploy-GatewayV2Ha.Uninstall.ps1` script.
101+
To uninstall the high-availability deployment of Windows Admin Center from your failover cluster, run the `Deploy-GatewayV2Ha.Uninstall.ps1` script.
102102

103103
```powershell
104104
$parameters = @{
@@ -110,9 +110,9 @@ Deploy-GatewayV2Ha.Uninstall @parameters
110110

111111
## Troubleshooting
112112

113-
Logs are saved in the temp folder of the CSV. For example, `C:\ClusterStorage\Volume1\temp`.
113+
Logs are saved in the temp folder of the CSV. An example is `C:\ClusterStorage\Volume1\temp`.
114114

115-
If needed, you can run diagnostics by passing `Diagnostics` using the `-Mode` flag in the `Deploy-GatewayV2Ha.Inspect.ps1` script. The following example shows running the diagnostic collection for the last 24 hours on a cluster:
115+
If needed, you can run diagnostics by passing `Diagnostics` by using the `-Mode` flag in the `Deploy-GatewayV2Ha.Inspect.ps1` script. The following example shows running the diagnostic collection for the last 24 hours on a cluster:
116116

117117
```powershell
118118
$parameters = @{
Lines changed: 35 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,94 +1,85 @@
11
---
22
title: Install Windows Admin Center
3-
description: Learn how to install Windows Admin Center on a Windows PC or on a server so that multiple users can access Windows Admin Center using a web browser.
3+
description: Learn how to install Windows Admin Center on a Windows PC or on a server so that multiple users can access Windows Admin Center by using a web browser.
44
ms.topic: install-set-up-deploy
55
author: robinharwood
66
ms.author: roharwoo
77
ms.date: 05/28/2025
88
---
99
# Install Windows Admin Center
1010

11-
This article explains how to install Windows Admin Center on a Windows PC or a Windows Server remote server so multiple users can use Windows Admin Center in a web browser.
11+
This article explains how to install Windows Admin Center on a Windows PC or a Windows Server remote server so that multiple users can use Windows Admin Center in a web browser.
1212

1313
> [!TIP]
14-
> New to Windows Admin Center?
15-
> [Learn more about Windows Admin Center](../overview.md) or [download now](https://www.microsoft.com/evalcenter/download-windows-admin-center).
14+
> New to Windows Admin Center? Learn more about [Windows Admin Center](../overview.md) or [download now](https://www.microsoft.com/evalcenter/download-windows-admin-center).
1615
1716
## Determine your installation type
1817

19-
Review the [installation options](../plan/installation-options.md), which include the [supported operating systems](../plan/installation-options.md#installation-supported-operating-systems). To install Windows Admin Center on a virtual machine in Azure, see [Deploy Windows Admin Center in Azure](../azure/deploy-wac-in-azure.md).
18+
Review the [installation options](../plan/installation-options.md), which include the [supported operating systems](../plan/installation-options.md#installation-supported-operating-systems). To install Windows Admin Center on a virtual machine (VM) in Azure, see [Deploy Windows Admin Center in Azure](../azure/deploy-wac-in-azure.md).
2019

2120
## Download the Windows Admin Center installer
2221

2322
Download the Windows Admin Center installer from the [Windows Admin Center Evaluation Center](https://www.microsoft.com/evalcenter/download-windows-admin-center) to a location on the machine where you want to install Windows Admin Center.
2423

2524
## Prerequisites
2625

27-
To install Windows Admin Center, you need the following prerequisites:
28-
29-
- A Windows PC or server to install Windows Admin Center on.
30-
31-
- Admin privileges or equivalent permissions on the machine you're installing Windows Admin Center on.
32-
33-
- Optional: An SSL certificate for _Server Authentication (1.3.6.1.5.5.7.3.1)_. Use a self-signed certificate for testing, but always use a certificate from a trusted certificate authority for production environments. If you don't have a certificate, use the Windows Admin Center installer to generate a self-signed certificate. The certificate is valid for 60 days.
26+
- A Windows PC or server on which to install Windows Admin Center.
27+
- Admin privileges or equivalent permissions on the machine on which you're installing Windows Admin Center.
28+
- Optional: A TLS/SSL certificate for _Server Authentication (1.3.6.1.5.5.7.3.1)_. Use a self-signed certificate for testing, but always use a certificate from a trusted certificate authority for production environments. If you don't have a certificate, use the Windows Admin Center installer to generate a self-signed certificate. The certificate is valid for 60 days.
3429

3530
## Install Windows Admin Center
3631

37-
To install Windows Admin Center, perform the following steps:
32+
To install Windows Admin Center, follow the steps for the desktop experience or Windows Server Core.
3833

39-
### [Desktop Experience](#tab/desktop-experience)
34+
### [Desktop experience](#tab/desktop-experience)
4035

41-
To install Windows Admin Center on your machine running the Windows Server Desktop Experience, follow these steps:
36+
To install Windows Admin Center on your machine running the Windows Server desktop experience, follow these steps:
4237

4338
1. Sign in to the machine where you want to install Windows Admin Center.
4439

45-
1. Run the Windows Admin Center installer you previously downloaded.
40+
1. Run the Windows Admin Center installer that you previously downloaded.
4641

47-
![Screenshot of the Windows Admin Center v2 Installer setup wizard welcome screen.](../media/windows-admin-center-v2-installer.png)
42+
![Screenshot that shows the Windows Admin Center v2 installer setup wizard welcome page.](../media/windows-admin-center-v2-installer.png)
4843

49-
1. On **Welcome to the Windows Admin Center setup wizard**, select **Next** to continue.
44+
1. On the **Welcome to the Windows Admin Center setup wizard** page, select **Next**.
5045

51-
1. On **License Terms and Privacy Statement**, if you agree to the terms, select **I accept these terms and understand the privacy statement**, and then select **Next** to prepare your environment and start the installation process.
46+
1. On the **License Terms and Privacy Statement** page, if you agree to the terms, select **I accept these terms and understand the privacy statement**. Then select **Next** to prepare your environment and start the installation process.
5247

53-
![Screenshot of the Windows Admin Center v2 Installer with two installation modes for express or custom setup.](../media/windows-admin-center-v2-installation-mode.png)
48+
![Screenshot that shows the Windows Admin Center v2 installer with two installation modes for express or custom setup.](../media/windows-admin-center-v2-installation-mode.png)
5449

55-
1. In **Select installation mode**, select either **Express setup** or **Custom setup**.
50+
1. On the **Select installation mode** page, select either **Express setup** or **Custom setup**:
5651

57-
Express setup determines your network access and port selection based on your operating system. Express setup doesn't allow for configuration of extra features.
52+
- **Express setup**: Determines your network access and port selection based on your operating system. Express setup doesn't allow for configuration of extra features.
53+
- **Custom setup**: Allows you to configure network access, port numbers, Transport Layer Security (TLS) certificate type and thumbprint, fully qualified domain name of the endpoint, trusted hosts mode, and WinRM over HTTPS.
5854

59-
Custom setup allows you to configure: network access, port numbers, TLS certificate type and thumbprint, fully qualified domain name of the endpoint, trusted hosts mode, and WinRM over HTTPS.
55+
1. Select **Next**.
6056

61-
Select **Next**.
57+
1. On the **Select TLS certificate** page, select the option that matches your needs, and then select **Next**.
6258

63-
1. In **Select TLS certificate**, select the option that matches your needs, and then select **Next**.
59+
You must select which TLS certificate that Windows Admin Center should use. If you already have a certificate, it must be installed in the `LocalMachine\My` certificates store. If you install Windows Admin Center for testing purposes only, the installer can generate a self-signed certificate that expires after 60 days.
6460

65-
You must select which Transport Layer Security (TLS) certificate Windows Admin Center should use. If you already have a certificate, it must be installed in the `LocalMachine\My` certificates store. If you're installing Windows Admin Center for testing purposes only, the installer can generate a self-signed certificate that expires after 60 days.
61+
![Screenshot that shows the Windows Admin Center v2 installer with the certificate options.](../media/select-tls-certificate.png)
6662

67-
![Screenshot of the Windows Admin Center v2 Installer with the option to either select a pre-installed TLS certificate or to generate a self-signed certificate.](../media/select-tls-certificate.png)
63+
1. On the **Automatic updates** page, select your preferred update option. The recommended option to install updates automatically is selected by default. Then select **Next**.
6864

69-
1. In **Automatic updates**, select your preferred update option. The recommended option to install updates automatically is selected by default. Then select **Next**.
70-
71-
1. In **Send diagnostic data to Microsoft**, select your preference, and then select **Next**.
65+
1. On the **Send diagnostic data to Microsoft** page, select your preference, and then select **Next**.
7266

7367
1. Review **Ready to install**, and then select **Install** to start the installation process.
7468

75-
1. After the installation process finishes, check the box to **Start Windows Admin Center**, and then select **Finish**.
69+
1. After the installation process finishes, select **Start Windows Admin Center** checkbox, and then select **Finish**.
7670

7771
1. Sign in as an administrator to start using Windows Admin Center.
7872

79-
![Screenshot of the Windows Admin Center sign in page in the browser window.](../media/sign-in-to-windows-admin-center.png)
80-
81-
You installed Windows Admin Center on your machine.
73+
![Screenshot that shows the Windows Admin Center sign-in page in the browser window.](../media/sign-in-to-windows-admin-center.png)
8274

8375
### [Server Core](#tab/server-core)
8476

85-
To install Windows Admin Center on your machine running the Windows Server Core experience or using PowerShell, follow these steps:
77+
To install Windows Admin Center on a machine running the Windows Server Core experience or by using Windows PowerShell, follow these steps:
8678

87-
1. Sign in to your machine. If you're on Server core, from the SConfig menu, enter option **15**, and then press <kbd>Enter</kbd>
88-
to open a PowerShell session. If you're on the desktop experience, remote desktop into your VM and launch PowerShell.
79+
1. Sign in to your machine. If you're on Server Core, from the `SConfig` menu, enter option **15**, and then select <kbd>Enter</kbd>
80+
to open a PowerShell session. If you're on the desktop experience, remote desktop into your VM and start PowerShell.
8981

90-
1. Download the Windows Admin Center installer
91-
and copy it to your computer by using the following PowerShell command:
82+
1. Download the Windows Admin Center installer, and copy it to your computer by using the following PowerShell command:
9283

9384
```powershell
9485
$parameters = @{
@@ -104,22 +95,23 @@ To install Windows Admin Center on your machine running the Windows Server Core
10495
Start-Process -FilePath '.\WindowsAdminCenter.exe' -ArgumentList '/VERYSILENT' -Wait
10596
```
10697

107-
1. You might also need to start the Windows Admin Center service by using the following command:
98+
1. You might also need to start Windows Admin Center by using the following command:
10899

109100
```powershell
110101
Start-Service -Name WindowsAdminCenter
111102
```
103+
112104
> [!TIP]
113105
> You can use the following options for the `-ArgumentList` parameter:
106+
>
114107
> - /Silent
115108
> - /VerySilent
116109
> - /HTTPSPortNumber
117110
> - /CertificateThumbprint
118111
>
119-
> To specify the HTTPS port number and certificate thumbprint on install through PowerShell, run the following command:
112+
> To specify the HTTPS port number and certificate thumbprint on installation through PowerShell, run the following command:
113+
>
120114
> ```powershell
121115
> .\WindowsAdminCenter2511.exe /HTTPSPortNumber=1234 /CertificateThumbprint=“1234abcd4567efgh”
122116
123-
You've now installed Windows Admin Center on your machine.
124-
125117
---

0 commit comments

Comments
 (0)