PowerShell Logo Small

Disable-NetAdapterSriov



This is the built-in help made by Microsoft for the command 'Disable-NetAdapterSriov', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 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

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.