PowerShell Logo Small

Disable-NetAdapterSriov



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

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] [-WhatIf] [<CommonParameters>]
Disable-NetAdapterSriov [-AsJob] [-CimSession <CimSession[]>] [-NoRestart] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]>
[-Confirm] [-WhatIf] [<CommonParameters>]
Disable-NetAdapterSriov [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-NoRestart] [-PassThru] [-ThrottleLimit <Int32>]
-InterfaceDescription <String[]> [-Confirm] [-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 switch 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 nearly 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 virtual 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 synthetic network path.



<

RELATED LINKS

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"



PS C:\>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.