PowerShell Logo Small

Rename-NetAdapter



This is the built-in help made by Microsoft for the command 'Rename-NetAdapter', in PowerShell version 4 - as retrieved from Windows version 'Microsoft Windows 8.1 Enterprise' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Renames a network adapter.

SYNTAX


Rename-NetAdapter [-Name] <String[]> [-NewName] <String> [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-PassThru] [-ThrottleLimit <Int32>] [-Confirm] [-What
If] [<CommonParameters>]
Rename-NetAdapter [-NewName] <String> [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-PassThru] [-ThrottleLimit <Int32>] -InterfaceDescription <String[]> [-C
onfirm] [-WhatIf] [<CommonParameters>]
Rename-NetAdapter [-NewName] <String> [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<C
ommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Rename-NetAdapter cmdlet renames a network adapter. Note: Only the name, or interface alias, can be changed and not the interface description.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=287415
Disable-NetAdapter
Enable-NetAdapter
Get-NetAdapter
Restart-NetAdapter
Set-NetAdapter

REMARKS

<

Examples


EXAMPLE 1

PS C:\>Rename-NetAdapter –Name Ethernet –NewName ManagementAdapter


This cmdlet renames a network adapter from the current name, by matching the pattern e*t, to the new name ManagementAdapter. A typical match of e*t is the default nam
e Ethernet.
PS C:\>Rename-NetAdapter –Name E*t –NewName ManagementAdapter



This example renames a network adapter from the current name of Ethernet to the new name ManagementAdapter.