This is the built-in help made by Microsoft for the command 'New-NetAdapterAdvancedProperty', 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.
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>] -Interfa
ceDescription <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 cm
dlet 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 th
at 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 Nam
e parameter or InterfaceDescription parameter, is not supported.
<
Online Version: http://go.microsoft.com/fwlink/p/?linkid=287413
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 networ
k 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.