This is the built-in help made by Microsoft for the command 'New-NetAdapterAdvancedProperty', in PowerShell version 3 - as retrieved from
Windows version 'Microsoft Windows Server 2012 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.
Creates a new advanced property for the network adapter.
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>]
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.
<
Get-NetAdapterAdvancedProperty
Remove-NetAdapterAdvancedProperty
Reset-NetAdapterAdvancedProperty
Set-NetAdapterAdvancedProperty
<
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.