Skip to content

Commit 1c24166

Browse files
committed
Initial draft
1 parent a7fe948 commit 1c24166

3 files changed

Lines changed: 112 additions & 0 deletions

File tree

WindowsServerDocs/administration/windows-commands/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1064,6 +1064,8 @@
10641064
href: netsh-advfirewall.md
10651065
- name: netsh branchcache
10661066
href: netsh-branchcache.md
1067+
- name: netsh bridge
1068+
href: netsh-bridge.md
10671069
- name: netsh delete
10681070
href: netsh-delete.md
10691071
- name: netsh dhcpclient
Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
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)

WindowsServerDocs/administration/windows-commands/windows-commands.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -556,6 +556,7 @@ To find information about a specific command, in the following A-Z menu, select
556556
- [netsh add](netsh-add.md)
557557
- [netsh advfirewall](netsh-advfirewall.md)
558558
- [netsh branchcache](netsh-branchcache.md)
559+
- [netsh bridge](netsh-bridge.md)
559560
- [netsh delete](netsh-delete.md)
560561
- [netsh dhcpclient](netsh-dhcpclient.md)
561562
- [netsh dnsclient](netsh-dnsclient.md)

0 commit comments

Comments
 (0)