|
| 1 | +--- |
| 2 | +title: netsh bridge |
| 3 | +description: The netsh bridge command manages network adapter bridge settings to combine two or more network segments as one network in Windows. |
| 4 | +ms.topic: reference |
| 5 | +ms.author: alalve |
| 6 | +author: xelu86 |
| 7 | +ms.date: 10/10/2025 |
| 8 | +--- |
| 9 | + |
| 10 | +# netsh bridge |
| 11 | + |
| 12 | +The `netsh bridge` command configures network adapter bridge settings in Windows. By creating a network bridge, you can link two or more network segments, allowing devices on separate segments to communicate seamlessly as if they're part of a single network. |
| 13 | + |
| 14 | +## Syntax |
| 15 | + |
| 16 | +``` |
| 17 | +netsh bridge [add | create | destroy | dump | help | list | remove | set | show | ?] |
| 18 | +``` |
| 19 | + |
| 20 | +``` |
| 21 | +netsh bridge add <Adapter ID> to <Bridge GUID> |
| 22 | +``` |
| 23 | + |
| 24 | +``` |
| 25 | +netsh bridge create [<Adapter ID #1> <Adapter ID #2>] |
| 26 | +``` |
| 27 | + |
| 28 | +``` |
| 29 | +netsh bridge destroy <Bridge GUID> |
| 30 | +``` |
| 31 | + |
| 32 | +``` |
| 33 | +netsh bridge list |
| 34 | +``` |
| 35 | + |
| 36 | +``` |
| 37 | +netsh bridge remove <Adapter ID> from <Bridge GUID> |
| 38 | +netsh bridge remove all from <Bridge GUID> |
| 39 | +``` |
| 40 | + |
| 41 | +``` |
| 42 | +netsh bridge set adapter [id=]<integer> [[forcecompatmode=]enable|disable] |
| 43 | +``` |
| 44 | + |
| 45 | +``` |
| 46 | +netsh bridge show adapter |
| 47 | +``` |
| 48 | + |
| 49 | +## Parameters |
| 50 | + |
| 51 | +| Command | Description | |
| 52 | +|--|--| |
| 53 | +| bridge `add` | Adds a network adapter, specified by its Adapter ID, to an existing bridge identified by its Bridge GUID. | |
| 54 | +| bridge `create` | Creates a new network bridge that includes two specified network adapters. The newly created bridge is assigned its own unique GUID, which can be retrieved using the `netsh bridge list` command. | |
| 55 | +| bridge `destroy` | Removes all network adapters from the specified bridge, identified by its bridge GUID, and deletes the bridge. | |
| 56 | +| bridge `dump` | Creates a script containing the current context configuration. The script can be saved to a file and used to restore settings if they're altered or need to be replicated on another system. | |
| 57 | +| bridge `list` | Displays all the created bridges that are uniquely identified by the bridge GUID. | |
| 58 | +| bridge `remove` | Removes a network adapter, specified by its Adapter ID, from a bridge identified by its Bridge GUID. <br><br> Using the `all` parameter removes all network adapters from the specified bridge and deletes the bridge. | |
| 59 | +| bridge `set adapter` | Modifies the bridge configuration for the specified adapter. <br><br> `id` - The identifier of the network adapter to configure. To view available adapter IDs, use the `netsh bridge show adapter` command. <br> `forcecompatmode` - Specifies whether to enable or disable Layer 3 compatibility mode for the adapter: <br> - `enable`: Turns on Layer 3 mode. <br> - `disable`: Turns off Layer 3 mode. | |
| 60 | +| bridge `show adapter` | Displays a list of all available network adapters, including their Adapter IDs, current settings, and status flags, indicating which adapters can participate in a network bridge. | |
| 61 | +| `help` *or* `?` | Displays a list of commands and their descriptions in the current context. | |
| 62 | + |
| 63 | +## Examples |
| 64 | + |
| 65 | +To add a network adapter (Adapter ID 3) to an existing bridge, with Bridge GUID `{12345678-ABCD-EF01-2345-6789ABCDEF03}`, run the following command: |
| 66 | + |
| 67 | +```cmd |
| 68 | +netsh bridge add adapter=3 bridge={12345678-ABCD-EF01-2345-6789ABCDEF03} |
| 69 | +``` |
| 70 | + |
| 71 | +To create a new network bridge with two adapters (Adapter ID 1 and Adapter ID 2), run the following command:** |
| 72 | + |
| 73 | +```cmd |
| 74 | +netsh bridge create adapter=1 adapter=2 |
| 75 | +``` |
| 76 | + |
| 77 | +To destroy a bridge and remove all its adapters (Bridge GUID `{12345678-ABCD-EF01-2345-6789ABCDEF02}`), run the following command: |
| 78 | + |
| 79 | +```cmd |
| 80 | +netsh bridge destroy bridge={12345678-ABCD-EF01-2345-6789ABCDEF02} |
| 81 | +``` |
| 82 | + |
| 83 | +To display all created network bridges and their GUIDs, run the following command: |
| 84 | + |
| 85 | +```cmd |
| 86 | +netsh bridge list |
| 87 | +``` |
| 88 | + |
| 89 | +To remove a network adapter (Adapter ID 2) from an existing bridge, with Bridge GUID `{12345678-ABCD-EF01-2345-6789ABCDEF02}`, run the following command: |
| 90 | + |
| 91 | +```cmd |
| 92 | +netsh bridge remove adapter=2 bridge={12345678-ABCD-EF01-2345-6789ABCDEF02} |
| 93 | +``` |
| 94 | + |
| 95 | +To display all available network adapters, run the following command: |
| 96 | + |
| 97 | +```cmd |
| 98 | +netsh bridge show adapter |
| 99 | +``` |
| 100 | + |
| 101 | +To modify an adapter (Adapter ID 1) in a bridge to enable Layer 3 compatibility mode, run the following command: |
| 102 | + |
| 103 | +```cmd |
| 104 | +netsh bridge set adapter id=1 forcecompatmode=enable |
| 105 | +``` |
| 106 | + |
| 107 | +## See also |
| 108 | + |
| 109 | +- [Command-Line Syntax Key](command-line-syntax-key.md) |
0 commit comments