PowerShell Logo Small

Disable-NetAdapterSriov



This is the built-in help made by Microsoft for the command 'Disable-NetAdapterSriov', 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

Disables Single-Root I/O Virtualization (SR-IOV) on the network adapter.

SYNTAX


Disable-NetAdapterSriov [-Name] <String[]> [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-NoRestart] [-PassThru] [-ThrottleLimit <Int32>] [-Confirm] [-WhatI
f] [<CommonParameters>]
Disable-NetAdapterSriov [-AsJob] [-CimSession <CimSession[]>] [-NoRestart] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<Co
mmonParameters>]
Disable-NetAdapterSriov [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-NoRestart] [-PassThru] [-ThrottleLimit <Int32>] -InterfaceDescription <String[]> [-Co
nfirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Disable-NetAdapterSriov cmdlet disables Single-Root I/O Virtualization (SR-IOV) on the network adapter. SR-IOV enables network traffic to bypass the software swit
ch layer of the Hyper-V virtualization stack. As a result, the I/O overhead in the software emulation layer is reduced and can achieve network performance that is nea
rly the same performance as in non-virtualized environments.


This cmdlet prevents the adapter from using SR-IOV until enabled again. While SR-IOV is disabled, Windows Server® 2012 and later will not attempt to allocate a virtua
l function (VF) to a virtual machine (VM). If VFs from this network adapter are allocated to any VM, then the VFs are revoked and each VM interface reverted to the sy
nthetic network path.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=287379
Enable-NetAdapterSriov
Get-NetAdapter
Get-NetAdapterSriov
Get-NetAdapterSriovVf
Get-NetAdapterSriov

REMARKS

<

Examples


EXAMPLE 1

PS C:\> Disable-NetAdapterSriov -Name "Ethernet 1"



This example disables SR-IOV on the network adapter named Ethernet 1 and restarts the network adapter.




EXAMPLE 2

PS C:\>$netAdapter3 = Get-NetAdapter –Name "Ethernet 3"
Disable-NetAdapterSriov –InputObject $netAdapter3

A version of the cmdlet that uses the pipeline to select the network adapter named Ethernet 3 and pipes that object into this cmdlet.
PS C:\> Get-NetAdapter –Name "Ethernet 3" | Disable-NetAdapterSriov



This example gets a network adapter named Ethernet 3, and disables the network adapter before restarting the network adapter.




EXAMPLE 3

PS C:\> Disable-NetAdapterSriov -Name "Ethernet 2" -NoRestart



This example disables SR-IOV on the network adapter named Ethernet 1 without restarting the network adapter.