Skip to content

Commit c314bd8

Browse files
authored
Refine title and description in OpenSSH installation guide
Edit review per CI 7023
1 parent ffb6c80 commit c314bd8

1 file changed

Lines changed: 16 additions & 16 deletions

File tree

support/windows-server/system-management-components/cant-install-openssh-features.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Can't install OpenSSH features
3-
description: Describes how to resolve issues that occur when you try to install OpenSSH Server and OpenSSH Client. The solutions to these issues vary for different versions of Windows Server and Windows Client.
2+
title: Can't install OpenSSH Features
3+
description: Resolves various issues that occur when you try to install OpenSSH Server and OpenSSH Client on different versions of Windows Server and Windows Client.
44
ms.date: 09/21/2025
55
manager: dcscontentpm
66
audience: itpro
@@ -15,9 +15,9 @@ ms.custom:
1515

1616
*Applies to:* Windows Server 2025, Windows Server 2022, Windows Server 2019, Windows 11, and Windows 10
1717

18-
The OpenSSH Server and OpenSSH Client features of Windows are installed by default on Windows Server 2025. However, for older versions of Windows Server and for Windows 11 and Windows 10, these features aren't installed by default. They're available as optional Windows features (also known as Features on Demand, or FoD).
18+
The OpenSSH Server and OpenSSH Client features of Windows are installed by default on Windows Server 2025. However, this situation isn't true for older versions of Windows Server or for Windows 11 or Windows 10. On those systems, the OpenSSH features are available as optional Windows features (also known as Features on Demand, or FoD).
1919

20-
For more information about using OpenSSH features in Windows Server 2025, see [Get started with OpenSSH for Windows](/windows-server/administration/openssh/openssh_install_firstuse?tabs=powershell&pivots=windows-server-2025).
20+
For more information about how to use OpenSSH features in Windows Server 2025, see [Get started with OpenSSH for Windows](/windows-server/administration/openssh/openssh_install_firstuse?tabs=powershell&pivots=windows-server-2025).
2121

2222
## Symptoms
2323

@@ -27,7 +27,7 @@ You try to install the OpenSSH features on a computer that's affected by any of
2727
- You use Group Policy to manage how the computer gets updates.
2828
- You use a centralized network store or an intranet update management system such as Windows Server Update Service (WSUS) to manage updates.
2929

30-
For example, when you run `Add-Capability` in Windows PowerShell, the installation fails and you see one of the following errors:
30+
For example, when you run `Add-Capability` in Windows PowerShell, the installation fails, and you receive one of the following error messages:
3131

3232
- 0x800F0954 (CBS_E_NO_OPTIONAL_CONTENT_FOUND_ON_UPDATE_SERVERS)
3333
- 0x800F0950 (COMException)
@@ -39,40 +39,40 @@ Additionally, if you do successfully install the OpenSSH features, you can't use
3939

4040
## Cause
4141

42-
Installing the OpenSSH features is straightforward if your computer gets automatic updates from Windows Update, or if your installation media is available locally. You install these features by using the user interface or the Deployment Image Servicing and Management (DISM) `Add-Capability` command.
42+
If your computer gets automatic updates from Windows Update, or if your installation media is available locally, the process to install the OpenSSH features is straightforward. You install these features by using the user interface or the Deployment Image Servicing and Management (DISM) `Add-Capability` command.
4343

4444
However, any of the following factors can complicate this operation:
4545

4646
- The computer is isolated from the internet.
4747
- You use Group Policy to manage how the computer gets updates.
4848
- You use a centralized network store or an intranet update management system such as Windows Server Update Service (WSUS) to manage updates.
4949

50-
In such situations, Windows can't locate the .CAB files that it needs to install the features. The reasons for this outcome can vary. For example,
50+
In such situations, Windows can't locate the .CAB files that it has to have to install the features. The reasons for this outcome can vary. For example,
5151

52-
- The installation media doesn't contain the .CAB files for the OpenSSH feature. This issue has been observed in Windows Server 2019, v 1809.
52+
- The installation media doesn't contain the .CAB files for the OpenSSH feature. This issue has been observed in Windows Server 2019, version 1809.
5353

54-
- The computer uses WSUS to manage updates, and runs a version of Windows Server that's older than Windows Server 2025 or Windows 11, v 22H2. These older versions of Windows can't install the OpenSSH features by using WSUS. For more information about this behavior, see the following articles:
54+
- The computer uses WSUS to manage updates, and runs a version of Windows Server that's older than Windows Server 2025 or Windows 11, version 22H2. These older versions of Windows can't install the OpenSSH features by using WSUS. For more information about this behavior, see the following articles:
5555

5656
- [Use Windows Update client policies and WSUS together](/windows/deployment/update/wufb-wsus).
5757
- The [High-level changes affecting Features on Demand and language pack content](/windows/deployment/update/fod-and-lang-packs#high-level-changes-affecting-features-on-demand-and-language-pack-content) section of "How to make Features on Demand and language packs available when you're using WSUS or Configuration Manager".
5858

59-
- Group Policy settings block the installation. These settings vary depending on the Windows version, and in some cases multiple settings can contradict each other and cause the installation to fail.
59+
- Group Policy settings block the installation. These settings vary depending on the Windows version. In some cases multiple settings can contradict one another and cause the installation to fail.
6060

6161
## Resolution
6262

6363
Before you start the procedures in this section, check the following requirements:
6464

65-
- The computer where you want to install the OpenSHH features runs Windows Server 2019 (build 1809) or a later version, or Windows 10 (build 1809) or a later version. To check the version details for your Windows computer, open a Command Prompt window and then enter `winver.exe`.
65+
- The computer on which you want to install the OpenSHH features runs Windows Server 2019 (build 1809) or a later version, or Windows 10 (build 1809) or a later version. To check the version details of your Windows-based computer, open a Command Prompt window, and then enter `winver.exe`.
6666

67-
- You're using Windows PowerShell 5.1 or a later version. To check the PowerShell version, open a PowerShell Command Prompt window and then run `$PSVersionTable.PSVersion`. Verify that the major version is at least **5**, and the minor version at least **1**. For more information, see [installing PowerShell on Windows](/powershell/scripting/install/installing-powershell-on-windows).
67+
- You use Windows PowerShell 5.1 or a later version. To check the PowerShell version, open a PowerShell Command Prompt window, and then run `$PSVersionTable.PSVersion`. Verify that the major version is at least **5**, and the minor version is at least **1**. For more information, see [installing PowerShell on Windows](/powershell/scripting/install/installing-powershell-on-windows).
6868

69-
- You're using an account that is a member of the built-in Administrators group.
69+
- You use an account that's a member of the built-in Administrators group.
7070

71-
The specific steps to install the OpenSSH features vary depending on the environment that you're working in.
71+
The specific steps to install the OpenSSH features vary depending on the environment that you work in.
7272

7373
| Environment | Start at this section |
7474
| - | - |
75-
| Target computer can connect to Windows Update as needed | [Install the OpenSSH features by using Windows Update](#install-the-openssh-features-by-using-windows-update) |
75+
| Target computer can connect to Windows Update as necessary | [Install the OpenSSH features by using Windows Update](#install-the-openssh-features-by-using-windows-update) |
7676
| Target computer can't connect to Windows Update | [Install the OpenSSH features from a network location](#install-the-openssh-features-from-a-network-location) |
7777
| WSUS* manages updates for the environment<br />And<br />The computer runs the following Windows versions: <ul><li>Windows Server 2022</li><li>Windows Server 2019</li><li>Windows 11, v 21H2</li><li>Windows 10</li></ul> | [Install the OpenSSH features from a network location](#install-the-openssh-features-from-a-network-location) |
7878

@@ -81,7 +81,7 @@ The specific steps to install the OpenSSH features vary depending on the environ
8181
If the installation still fails, see [Configure Group Policy to allow OpenSSH installation](#configure-group-policy-to-allow-openssh-installation)
8282

8383
> [!IMPORTANT]
84-
> Although in Windows Server 2025 the OpenSSH features are installed by default, you must start and configure them before you can use them (this procedure is the same for all supported versions of Windows). For more information, see [Configure the OpenSSH service and firewall settings](#configure-the-openssh-service-and-firewall-settings).
84+
> Although the OpenSSH features are installed by default in Windows Server 2025, you must start and configure the features before you can use them. (This procedure is the same for all supported versions of Windows.) For more information, see [Configure the OpenSSH service and firewall settings](#configure-the-openssh-service-and-firewall-settings).
8585
8686
### Install the OpenSSH features by using Windows Update
8787

0 commit comments

Comments
 (0)