Intel® Ethernet Adapters and Devices User Guide
Transitioning from Intel® PROSet to Ethernet Cmdlets for Intel® Ethernet
This guide serves as a resource for migrating from the legacy Intel® PROSet to Ethernet Cmdlets for Intel® Ethernet. It includes Cmdlet mapping and usage examples to help transition.
Cmdlet Mapping
The table below outlines the mapping from legacy PROSet Cmdlets to their new Ethernet Cmdlet counterparts:
Legacy PROSet Cmdlet | New/Replacement Cmdlet(s) |
|---|---|
Get-IntelNetAdapter | Get-IntelEthernet |
Get-IntelNetAdapterProfileSettings Get-IntelNetAdapterSetting Get-IntelNetAdapterStatus Set-IntelNetAdapterSetting | Get-IntelEthernetProfileSetting Get-IntelEthernetSetting Get-IntelEthernet, Get-IntelEthernetDCBStatus Set-IntelEthernetSetting |
Test-IntelNetDiagnostics Test-IntelNetIdentityAdapter SaveRestore.ps1 | Test-IntelEthernetHardware Invoke-IntelEthernetIdentifyPort Save-/Restore-IntelEthernetConfiguration |
Migration Examples
Adapter Inventory:
Legacy:
POWERSHELL:
Get-IntelNetAdapter
New:
POWERSHELL:
Get-IntelEthernet # Retrieve all adapters Get-IntelEthernet | Format-List # Display in list view Get-IntelEthernet -Name "Intel(R) Ethernet Network Adapter E810-C-Q2" # Filter by exact name Get-IntelEthernet -Name "*E810*" # Use wildcard for family $Adapters = Get-IntelEthernet $Adapters | Get-IntelEthernet # Pipeline example Get-IntelEthernet -Adapter $Adapters[1] # Specific object retrieval Get-IntelEthernet -Name $Adapters[1].ifDesc # Use NetAdapter name
Adapter Settings (Recovery):
Legacy:
POWERSHELL:
Get-IntelNetAdapterSetting -DisplayName "Receive Side Scaling"
New:
POWERSHELL:
Get-IntelEthernetSetting # Retrieve all settings Get-IntelEthernetSetting | Format-List # Display in list view Get-IntelEthernetSetting -Name "Intel(R) Ethernet Network Adapter E810-C-Q2" # Filter by adapter name $Adapters = Get-IntelEthernet $Adapters[1] | Get-IntelEthernetSetting # Pipeline adapter example Get-IntelEthernetSetting -Name $Adapters[1].Name -DisplayName "Receive Side Scaling" # Specific setting retrieval Get-IntelEthernetSetting -RegistryKeyword "*RSS" # Filter by registry keyword Get-IntelEthernetSetting -RegistryKeyword "*RSS" | Select Minihelp # Minihelp example
Setting Modification:
Legacy:
POWERSHELL:
Set-IntelNetAdapterSetting -Name $n -DisplayName "Receive Side Scaling" -DisplayValue Disabled
New:
POWERSHELL:
Set-IntelEthernetSetting -Name "Intel(R) Ethernet Network Adapter E810-C-Q2" -RegistryKeyword "*RSS" -RegistryValue "1" # Enable via registry $Adapters = Get-IntelEthernet Set-IntelEthernetSetting -Adapter $Adapters[1] -DisplayName "Receive Side Scaling" -DisplayValue "Disabled" | Format-List # Disable by display value $RSS = Get-IntelEthernetSetting -Name "Intel(R) Ethernet Network Adapter E810-C-Q2" -RegistryKeyword "*RSS" Set-IntelEthernetSetting -Setting $RSS -Reset # Reset example $Adapters = Get-IntelEthernet; $Adapters[1] | Set-IntelEthernetSetting -RegistryKeyword "*RSS" -RegistryValue 1 # Pipeline adapter example $RSS = Get-IntelEthernetSetting -DisplayName "Receive Side Scaling"; $RSS | Set-IntelEthernetSetting -DisplayValue "Disabled" # Pipeline setting object example
Profile Evaluation:
Legacy:
POWERSHELL:
Get-IntelNetAdapterProfileSettings -Name $n -ProfileName "Standard Server"
New:
POWERSHELL:
Get-IntelEthernetProfileSetting -Name "Intel(R) Ethernet Server Adapter E810-C-Q2" -ProfileName "Standard Server" # Profile evaluation $Adapters = Get-IntelEthernet Get-IntelEthernetProfileSetting -Adapter $Adapters[1] -ProfileName "Standard Server" # Pipeline example $Adapters = Get-IntelEthernet Get-IntelEthernetProfileSetting -Adapter $Adapters[1] -ProfileName "Standard Server" Set-IntelEthernetSetting -Name $Adapters[1].Name -DisplayName "Profile" -DisplayValue "Standard Server" # Apply profile
Identity/Blink Port:
Legacy:
POWERSHELL:
Test-IntelNetIdentifyAdapter -Name "Intel(R) Ethernet Network Adapter E810-C-Q2" -Seconds 45
New:
POWERSHELL:
Invoke-IntelEthernetIdentifyPort -Name "Intel(R) Ethernet Network Adapter E810-C-Q2" -Seconds 45 # Identify port $Adapters = Get-IntelEthernet Invoke-IntelEthernetIdentifyPort -Adapter $Adapters[1] -Seconds 45 # Pipeline example $Adapter = Get-IntelEthernet; Invoke-IntelEthernetIdentifyPort $Adapter[1] -Seconds 90 # Extended time example
Diagnostics/Hardware Tests:
Legacy:
POWERSHELL:
Test-IntelNetDiagnostics -Name "Intel(R) Ethernet 25G 2P E810-XXV Adapter"
New:
POWERSHELL:
$Adapters = Get-IntelEthernet; Test-IntelEthernetHardware -Adapter $Adapters[1] # Hardware test example Test-IntelEthernetHardware -Name "Intel(R) Ethernet 25G 2P E810-XXV Adapter" # Direct name example
DCB Status Snapshot:
Legacy:
POWERSHELL:
Get-IntelNetAdapterStatus -Name "*E810*" # (DCB-related info subset)
New:
POWERSHELL:
Get-IntelEthernetDCBStatus # Retrieve DCB status for all devices Get-IntelEthernetLogConfig -Name "*E810*" # Use wildcard for logging context $Adapters = Get-IntelEthernet; $Adapters | Get-IntelEthernetDCBStatus # Pipeline example
Save/Restore Configuration:
Legacy:
POWERSHELL:
SaveRestore.ps1
New:
POWERSHELL:
Save-IntelEthernetConfiguration # Default path save Save-IntelEthernetConfiguration -Path "C:\E810_Config.txt" # Custom path save Save-IntelEthernetConfiguration -SaveIPConfig $false # Skip IP data Save-IntelEthernetConfiguration -Path "C:\E810_Config.txt" -Force # Overwrite existing file Save-IntelEthernetConfiguration -Path "C:\E810_Config.txt" -SaveIPConfig $false -Force # Combined options Restore examples: Restore-IntelEthernetConfiguration -Path "C:\E810_Config.txt" Restore-IntelEthernetConfiguration -Path "C:\E810_Config.txt" -RestoreIPConfig $false
No Direct Equivalent PROSet Cmdlets:
For certain legacy cmdlets, directs equivalents are not available.
Legacy:
Get-IntelNetAdapterBandwidthPercentages Get-IntelNetIscsiBootCrashDump Set-IntelNetAdapterMaximumBandwidthPercentage Set-IntelNetAdapterMinimumBandwidthPercentage Set-IntelNetIscsiBootCrashDump Add-IntelNetTeamMember / Remove-IntelNetTeamMember Get-IntelNetTeamSetting / Set-IntelNetTeamSetting Set-IntelNetTeam Set-IntelNetVLAN Get-/Set-IntelNetVLANJumboPacket Set-IntelNetVLANJumboPacket
RDMA Installation Replication:
To replicate the PROSet RDMA installation process, refer to the readme file located at:
.\Disk\RDMA\Windows.