PowerShell Logo Small

Disable-NetAdapter



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

SYNTAX


Disable-NetAdapter [-Name] <String[]> [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-PassThru] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParamet
ers>]
Disable-NetAdapter [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Disable-NetAdapter [-AsJob] [-CimSession <CimSession[]>] [-IncludeHidden] [-PassThru] [-ThrottleLimit <Int32>] -InterfaceDescription <String[]> [-Confirm] [-WhatIf] [
<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Disable-NetAdapter cmdlet disables a network adapter. A network adapter must be enabled to connect to a network. This cmdlet causes loss of network connectivity o
f the specified network adapter. Note: Do not disable the network adapter being used to manage a remote computer. By default the user will be prompted to confirm the
network adapter should be disabled



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=287368
Enable-NetAdapter

REMARKS

<

Examples


EXAMPLE 1

PS C:\>Disable-NetAdapter -Name "Ethernet 2"


A version of the cmdlet that uses position.
PS C:\>Disable-NetAdapter "Ethernet 2"


A version of the cmdlet that uses position and wildcard characters.
PS C:\>Disable-NetAdapter E*2



This example disables a network adapter named Ethernet Connection 2.




EXAMPLE 2

PS C:\>Disable-NetAdapter –Name VMGuestTrafficAdapter –CimSession HyperVServer4



This example disables the network adapter named VMGuestTrafficAdapter on the remote computer named HyperVServer4.




EXAMPLE 3

PS C:\>Disable-NetAdapter –Name *



This example disables all network adapters. Note: If remotely managing a computer, then all network connectivity will be lost and cannot be remotely restored.




EXAMPLE 4

PS C:\>Disable-NetAdapter –Name MyAdapter
Confirm
Are you sure you want to perform this action?
Disable-NetAdapter ꞌMyAdapter'


[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):Y


A version of the cmdlet that overrides the default confirmation prompt when disabling the network adapter named MyAdapter. For more information about changing the def
ault confirmation prompt, see the $ConfirmPreference variable by running the Get-Help –Name about_Preference_Variables cmdlet.
PS C:\>Disable-NetAdapter –Name MyAdapter –Confirm:$false



This example disables the network adapter named MyAdapter.