Get-NetConnectionProfile is a Windows PowerShell command that allows users to view the network connection profiles on their computer. This command can be used to view information about the active network connections on a computer, such as the type of connection, the profile name, and the network adapter name. It can also be used to view the IP address, subnet mask, and default gateway of the active connections.
The Get-NetConnectionProfile command is a useful tool for troubleshooting network connection issues. It can be used to quickly view the active network connections on a computer and to identify any potential problems. It can also be used to view the IP address, subnet mask, and default gateway of the active connections.
Syntax
The syntax for the Get-NetConnectionProfile command is as follows:
Get-NetConnectionProfile [-Name] <String> [-InterfaceAlias] <String> [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-ComputerName <String[]>] [-Credential <PSCredential>] [-IncludeAllProfiles] [-IncludeDefaultGateway] [-IncludeIPAddress] [-IncludeSubnetMask] [-IncludeSuffix] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Parameters
The Get-NetConnectionProfile command has the following parameters:
| Parameter | Description |
|---|---|
| Name | Specifies the name of the network connection profile. |
| InterfaceAlias | Specifies the name of the network adapter. |
| CimSession | Specifies the CimSession object to use for the operation. |
| ThrottleLimit | Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer. |
| AsJob | Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. |
| ComputerName | Specifies the name of the computer on which the command should be run. |
| Credential | Specifies a user account that has permission to perform this action. |
| IncludeAllProfiles | Includes all network connection profiles. |
| IncludeDefaultGateway | Includes the default gateway of the active connections. |
| IncludeIPAddress | Includes the IP address of the active connections. |
| IncludeSubnetMask | Includes the subnet mask of the active connections. |
| IncludeSuffix | Includes the suffix of the active connections. |
| PassThru | Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output. |
| WhatIf | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
| Confirm | Prompts you for confirmation before running the cmdlet. |
Inputs
The Get-NetConnectionProfile command does not accept pipelined input.
Outputs
The Get-NetConnectionProfile command returns a NetConnectionProfile object.
Examples
The following example shows how to use the Get-NetConnectionProfile command to view the active network connections on a computer.
Get-NetConnectionProfile
The following example shows how to use the Get-NetConnectionProfile command to view the IP address, subnet mask, and default gateway of the active connections.
Get-NetConnectionProfile -IncludeIPAddress -IncludeSubnetMask -IncludeDefaultGateway
Tips
Here are some tips for using the Get-NetConnectionProfile command:
- Use the Name parameter to specify the name of the network connection profile.
- Use the InterfaceAlias parameter to specify the name of the network adapter.
- Use the IncludeAllProfiles parameter to include all network connection profiles.
- Use the IncludeIPAddress, IncludeSubnetMask, and IncludeDefaultGateway parameters to view the IP address, subnet mask, and default gateway of the active connections.
- Use the AsJob parameter to run the command as a background job.
- Use the ComputerName parameter to specify the name of the computer on which the command should be run.
- Use the Credential parameter to specify a user account that has permission to perform the action.
Conclusion
The Get-NetConnectionProfile command is a useful tool for troubleshooting network connection issues. It can be used to quickly view the active network connections on a computer and to identify any potential problems. It can also be used to view the IP address, subnet mask, and default gateway of the active connections.