Skip to content

Commit c2bbd4a

Browse files
committed
formatting changes
1 parent bd7d419 commit c2bbd4a

File tree

1 file changed

+60
-23
lines changed

1 file changed

+60
-23
lines changed

docset/winserver2022-ps/ServerManager/Get-WindowsFeature.md

+60-23
Original file line numberDiff line numberDiff line change
@@ -11,67 +11,90 @@ title: Get-WindowsFeature
1111
# Get-WindowsFeature
1212

1313
## SYNOPSIS
14-
Gets information about Windows Server roles, role services, and features that are available for installation and installed on a specified server.
14+
Gets information about Windows Server roles, role services, and features that are available for
15+
installation and installed on a specified server.
1516

1617
## SYNTAX
1718

1819
```
19-
Get-WindowsFeature [[-Name] <String[]>] [-Vhd <String>] [-ComputerName <String>] [-Credential <PSCredential>]
20-
[-LogPath <String>] [<CommonParameters>]
20+
Get-WindowsFeature [[-Name] <String[]>] [-Vhd <String>] [-ComputerName <String>]
21+
[-Credential <PSCredential>] [-LogPath <String>] [<CommonParameters>]
2122
```
2223

2324
## DESCRIPTION
24-
The `Get-WindowsFeature` cmdlet gets information about features that are both available for installation and already installed on a computer that is running Windows Server or an offline virtual hard disk (VHD) that is running Windows Server.
25+
26+
The `Get-WindowsFeature` cmdlet gets information about features that are both available for
27+
installation and already installed on a computer that is running Windows Server or an offline
28+
virtual hard disk (VHD) that is running Windows Server.
2529

2630
## EXAMPLES
2731

2832
### Example 1
33+
2934
```powershell
3035
Get-WindowsFeature -ComputerName Server1 -Credential contoso.com\user1
3136
```
3237

33-
This example gets a list of features that is available and installed on the target computer named Server1.
34-
The credentials for user user1 in the Contoso.com domain, a user who has Administrator rights on Server1, are provided.
38+
This example gets a list of features that is available and installed on the
39+
target computer named Server1.
40+
The credentials for user user1 in the Contoso.com domain, a user who has
41+
Administrator rights on Server1, are provided.
3542

3643
### Example 2
44+
3745
```powershell
3846
Get-WindowsFeature -Vhd D:\ps-test\vhd1.vhd
3947
```
4048

41-
This example returns a list of features that is available and installed on the specified offline VHD located at D:\ps-test\vhd1.vhd.
49+
This example returns a list of features that is available and installed on the specified offline VHD
50+
located at D:\ps-test\vhd1.vhd.
4251

4352
### Example 3
53+
4454
```powershell
4555
Get-WindowsFeature -Name AD*, Web*
4656
```
4757

48-
This example returns a list of available and installed features that have a command ID starting with AD or Web.
58+
This example returns a list of available and installed features that have a command ID starting with
59+
AD or Web.
4960

5061
### Example 4
62+
5163
```powershell
5264
Get-WindowsFeature -ComputerName Server01 | Where Installed
5365
```
5466

5567
This example returns a list of features installed on a specified server, Server01.
5668

5769
### Example 5
70+
5871
```powershell
5972
Get-WindowsFeature -ComputerName Server01 | Where InstallState -Eq Removed
6073
```
6174

62-
This example returns a list of features on a specified server, Server01, that have installation files removed from the local side-by-side store, and require an external file source for installation.
75+
This example returns a list of features on a specified server, Server01, that have installation
76+
files removed from the local side-by-side store, and require an external file source for
77+
installation.
6378

6479
## PARAMETERS
6580

6681
### -ComputerName
67-
Gets the list of available features from the specified remote computer that is running Windows Server.
68-
The parameter accepts only one computer name.
69-
If this parameter is not added, or no computer name is specified, the default target is the local computer.
70-
Valid values for the parameter include a NetBIOS name, an IP address, or a fully qualified domain name of a remote computer.
7182

72-
To use a remote computer's IP address as the value of this parameter, your command must include the `Credential` parameter.
73-
The computer must either be configured for HTTPS transport, or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the local computer.
74-
For information about adding a computer name to the WinRM TrustedHosts list, see "How to Add a Computer to the Trusted Host List" in [about_Remote_Troubleshooting](https://go.microsoft.com/fwlink/p/?LinkID=135188).
83+
Gets the list of available features from the specified remote computer that is running
84+
Windows Server.
85+
The parameter accepts only one computer name.
86+
If this parameter is not added, or no computer name is specified, the default target is the local
87+
computer.
88+
Valid values for the parameter include a NetBIOS name, an IP address, or a fully qualified domain
89+
name of a remote computer.
90+
91+
To use a remote computer's IP address as the value of this parameter, your command must include the
92+
`Credential` parameter.
93+
The computer must either be configured for HTTPS transport, or the IP address of the remote computer
94+
must be included in the WinRM TrustedHosts list on the local computer.
95+
For information about adding a computer name to the WinRM TrustedHosts list, see "How to Add a
96+
Computer to the Trusted Host List" in
97+
[about_Remote_Troubleshooting](https://go.microsoft.com/fwlink/p/?LinkID=135188).
7598

7699
```yaml
77100
Type: String
@@ -86,15 +109,18 @@ Accept wildcard characters: False
86109
```
87110
88111
### -Credential
112+
89113
Specifies a user account that has access rights to perform this action.
90-
If the parameter is not added, or no value is specified, the default value of this parameter is the current user.
114+
If the parameter is not added, or no value is specified, the default value of this parameter is the
115+
current user.
91116
Enter a user name in one of the following formats.
92117
Quotation marks are optional.
93118
94119
-- "UserName"
95120
-- "Domain\User"
96121
97-
-- A Credential object returned by the [Get-Credential](https://go.microsoft.com/fwlink/p/?LinkID=113311) cmdlet.
122+
-- A Credential object returned by the
123+
[Get-Credential](https://go.microsoft.com/fwlink/p/?LinkID=113311) cmdlet.
98124
99125
If a user name is entered, then a prompt for a password is displayed.
100126
@@ -111,6 +137,7 @@ Accept wildcard characters: False
111137
```
112138
113139
### -LogPath
140+
114141
Specifies a name and path to a log file.
115142
Add this parameter if the results of this cmdlet must be stored in a log.
116143
@@ -127,6 +154,7 @@ Accept wildcard characters: False
127154
```
128155
129156
### -Name
157+
130158
Specifies the command IDs of roles, role services, or features about which to return information.
131159
132160
```yaml
@@ -142,19 +170,25 @@ Accept wildcard characters: False
142170
```
143171
144172
### -Vhd
173+
145174
Specifies the path to an offline VHD.
146-
The path can either point to a VHD file, or to a location on which the VHD is already mounted by using Deployment Image Servicing and Management (DISM) tools.
175+
The path can either point to a VHD file, or to a location on which the VHD is already mounted by
176+
using Deployment Image Servicing and Management (DISM) tools.
147177
148178
The VHD can be on a local disk on the target computer, or on a network shared folder.
149179
If the VHD is in a network shared folder, then the value of this parameter is a UNC path to the VHD.
150-
In this case, the computer account of the computer that you are using to mount the VHD must have read and write permissions (Read/Write permissions in the File Sharing dialog box, or Full Control on the Security tab of the folder Properties dialog box) on the shared folder, or the VHD will not be accessible.
180+
In this case, the computer account of the computer that you are using to mount the VHD must have
181+
read and write permissions (Read/Write permissions in the File Sharing dialog box, or Full Control
182+
on the Security tab of the folder Properties dialog box) on the shared folder, or the VHD will not
183+
be accessible.
151184
Local loopback UNC paths are not supported.
152185
Use either of the following formats for the computer account: DOMAIN\SERVERNAME$ or SERVERNAME$.
153186
154187
Add the `ComputerName` parameter to specify the target computer you want to use to mount the VHD.
155188
If the `ComputerName` parameter is not specified, then the local computer is used.
156189
The computer that you are using to mount the VHD must be running Windows Server.
157-
Any local path, such as D:\myFolder, that is specified by using this parameter is always relative to the target computer.
190+
Any local path, such as D:\myFolder, that is specified by using this parameter is always relative to
191+
the target computer.
158192

159193
```yaml
160194
Type: String
@@ -169,7 +203,11 @@ Accept wildcard characters: False
169203
```
170204

171205
### CommonParameters
172-
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
206+
207+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
208+
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
209+
-WarningAction, and -WarningVariable. For more information, see
210+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
173211

174212
## INPUTS
175213

@@ -190,4 +228,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
190228
[Enable-ServerManagerStandardUserRemoting](./Enable-ServerManagerStandardUserRemoting.md)
191229

192230
[Disable-ServerManagerStandardUserRemoting](./Disable-ServerManagerStandardUserRemoting.md)
193-

0 commit comments

Comments
 (0)