PowerShell Logo Small

New-NetAdapterAdvancedProperty



This is the built-in help made by Microsoft for the command 'New-NetAdapterAdvancedProperty', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' 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

Creates a new advanced property for the network adapter.

SYNTAX


New-NetAdapterAdvancedProperty [-Name] <String> [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-NoRestart] [-RegistryDataType <RegDataType>] [-ThrottleLimit
<Int32>] -RegistryKeyword <String> -RegistryValue <String[]> [-Confirm] [-WhatIf] [<CommonParameters>]
New-NetAdapterAdvancedProperty [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-NoRestart] [-RegistryDataType <RegDataType>] [-ThrottleLimit <Int32>]
-InterfaceDescription <String> -RegistryKeyword <String> -RegistryValue <String[]> [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-NetAdapterAdvancedProperty cmdlet creates a new advanced property for the network adapter. The intention is that network adapter manufacturers can use this cmdlet to
manage advanced properties that are not directly supported by Windows Server® 2012 and later. Note: This cmdlet is the cmdlet in the network adapter family that creates a
registry key. All other cmdlets read or modify existing registry entries. Note: The use of wildcards in the network adapter identifier, either in the Name parameter or
InterfaceDescription parameter, is not supported.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=287413
Get-NetAdapterAdvancedProperty
Remove-NetAdapterAdvancedProperty
Reset-NetAdapterAdvancedProperty
Set-NetAdapterAdvancedProperty

REMARKS

<

Examples


EXAMPLE 1

PS C:\> New-NetAdapterAdvancedProperty –Name MyAdapter -RegistryKeyword "MyKeyword" -RegistryValue "1" -RegistryDataType REG_SZ



This example creates a new advanced property on the network adapter named MyAdapter with the registry keyword MyKeyword of type REG_SZ with the value 1.




EXAMPLE 2

PS C:\> New-NetAdapterAdvancedProperty -Name MyAdapter -RegistryKeyword "MyKeyword" -RegistryValue "1" -RegistryDataType REG_SZ -NoRestart



This example creates a new advanced property on the network adapter named MyAdapter with the registry keyword MyKeyword of type REG_SZ with the value 1 and the network
adapter is specified to not restart. Note: Many advanced properties require restarting the network adapter before the new settings take effect.




EXAMPLE 3

PS C:\> $networkAdapter3 = Get-NetAdapter –Name "Ethernet 3"
PS C:\> New-NetAdapterAdvancedProperty –InputObject $networkAdapter3 -RegistryKeyword "MyKeyword" -RegistryValue "1" -RegistryDataType REG_SZ

This is a version of the cmdlet that creates a new advanced property on the network adapter named Ethernet 3 using wildcard characters and the pipeline. Note: Use of
wildcard characters is not allowed for the network adapter identifier as part of this cmdlet, but can be used via the pipeline.
PS C:\> Get-NetAdapter –Name "Ethernet 3" | New-NetAdapterAdvancedProperty -RegistryKeyword "MyKeyword" -RegistryValue "1" -RegistryDataType REG_SZ



This example gets a network adapter and creates a new advanced property on the network adapter named Ethernet 3.