netsh wlan

适用于: ✅ Windows Server 2025, ✅ Windows Server 2022, ✅ Windows Server 2019, ✅ Windows Server 2016, ✅ Windows 11, ✅ Windows 10, ✅ Azure Local 2311.2 and later

该 netsh wlan 命令使管理员能够在 Windows 上配置、管理和排除无线网络故障。它提供了用于连接到 Wi-Fi 网络、管理无线配置文件、过滤 SSID、导出设置和诊断连接问题的子命令。

Syntax

netsh wlan [add | connect | delete | disconnect | dump | export | help | IHV | refresh | reportissues | set | show | start | stop | ?]

netsh wlan add filter [permission=]allow|block|denyall [ssid=]<string> [networktype=]infrastructure|adhoc
netsh wlan add profile [filename=]<string> [interface=]<string> [user=]all|current

netsh wlan connect [name=]<string> [ssid=]<string> [interface=]<string>

netsh wlan delete filter [permission=]allow|block|denyall [ssid=]<string> [networktype=]infrastructure|adhoc
netsh wlan delete profile [name=]<string> [[interface=]<string>]

netsh wlan disconnect [interface=]<string>

netsh wlan dump

netsh wlan export <hostednetworkprofile>
netsh wlan export profile [name=]<string> [folder=]<string> [[interface=]<string>] [key=<string>]

netsh wlan IHV <startlogging> <stoplogging>

netsh wlan refresh hostednetwork [data=]key

netsh wlan reportissues

netsh wlan set allowexplicitcreds [allow=]yes|no
netsh wlan set autoconfig [enabled=]yes|no [interface=]<string>
netsh wlan set blockednetworks [display=]show|hide
netsh wlan set blockperiod [value=]0-60
netsh wlan set createalluserprofile [enabled=]yes|no
netsh wlan set hostednetwork [mode=]allow|disallow [ssid=]<ssid> [key=]<passphrase> [keyUsage=]persistent|temporary
netsh wlan set profileorder [name=]<string> [interface=]<string> [priority=]<integer>
netsh wlan set profileparameter [name=]<string> [interface=]<string> [SSIDname=]<string> [ConnectionType=]ESS|IBSS
                                [autoSwitch=yes|no] [ConnectionMode=auto|manual] [nonBroadcast=yes|no]
                                [Randomization=]yes|no|daily [authentication=]open|shared|WPA|WPA2|WPAPSK|WPA2PSK
                                [encryption=]none|WEP|TKIP|AES [keyType=]networkKey|passphrase [keyIndex=]1-4
                                [keyMaterial=<string>] [PMKCacheMode=]yes|no [PMKCacheSize=]1-255 [PMKCacheTTL=300-86400]
                                [preAuthMode=]yes|no [preAuthThrottle=]1-16 [FIPS=]yes|no [useOneX=]yes|no
                                [authMode=]machineOrUser|machineOnly|userOnly|guest [ssoMode=]preLogon|postLogon|none
                                [maxDelay=]1-120 [allowDialog=]yes|no [userVLAN=]yes|no [heldPeriod=]1-3600
                                [AuthPeriod=1-3600] [StartPeriod=]1-3600 [maxStart=]1-100 [maxAuthFailures=]1-100
                                [cacheUserData=]yes|no [cost=]default|unrestricted|fixed|variable
netsh wlan set profiletype [name=]<string> [profiletype=]all|current [interface=]<string>
netsh wlan set randomization [enabled=]yes|no [interface=]<string>
netsh wlan set tracing [mode=]yes|no|persistent

netsh wlan show all
netsh wlan show allowexplicitcreds
netsh wlan show autoconfig
netsh wlan show blockednetworks
netsh wlan show createalluserprofile
netsh wlan show drivers
netsh wlan show filters
netsh wlan show hostednetwork
netsh wlan show interfaces
netsh wlan show networks
netsh wlan show onlyUseGPProfilesforAllowedNetworks
netsh wlan show profiles
netsh wlan show randomization
netsh wlan show settings
netsh wlan show tracing
netsh wlan show wirelesscapabilities
netsh wlan show wlanreport

netsh wlan start hostednetwork

netsh wlan stop hostednetwork

Parameters

Command	Description
无线局域网 `add`	`filter` - 将无线网络添加到允许或不允许的无线网络列表中。如果权限设置为 `allow` 或 `block`，则该参数`ssid`为必需。如果设置，`ssid`则`denyall`不是必需的。 `permission` - 设置过滤器的权限类型。 - `allow` - `block` - `denyall` `ssid` - 无线网络的 SSID。 `networktype` - 无线网络的网络类型。 - `infrastructure` - `adhoc` `profile` - 将 WLAN 配置文件添加到指定的网络接口： - `filename` （必需）：指定包含配置文件数据的 XML 文件。 - `interface` （可选）：命令列出 `show interface` 的无线接口的名称。如果提供，则配置文件仅添加到指定的接口;否则，它将添加到所有无线接口。 - `user` （可选）：确定配置文件是应用于所有（`all`）用户还是仅应用于当前（`current`）用户。默认情况下，配置文件将应用于所有用户。
无线局域网 `connect`	使用指定的配置文件连接到无线网络。如果有多个网络接口可用，则必须指定要使用的接口，否则可以省略接口参数。配置文件名称是必需的，而服务集标识符（SSID）是可选的。如果配置文件仅包含一个 SSID，则会自动使用该 SSID。如果配置文件中存在多个 SSID，则必须指定 SSID。指定接口时，不支持通配符名称。如果所选接口已连接到无线网络，则该命令会在尝试连接到新网络之前断开与当前网络的连接。如果当前网络和目标网络相同，则该命令返回成功而不进行更改。 `ssid`：指定无线网络的SSID。 `name`：指定要用于连接尝试的配置文件名称。 `interface`：指定尝试连接的接口名称。
无线局域网 `delete`	`filter` - 从允许或不允许的无线网络列表中删除无线网络。如果权限设置为 `allow` 或 `block`，则该参数`ssid`为必需。如果设置，`ssid`则`denyall`不是必需的。 `permission` - 设置过滤器的权限类型。 - `allow` - `block` - `denyall` `ssid` - 无线网络的 SSID。 `networktype` - 无线网络的网络类型。 - `infrastructure` - `adhoc` `profile` - 从指定的网络接口中删除 WLAN 配置文件： - `name` （必需）：指定要删除的配置文件的名称。配置文件名称可以包含通配符，并且将删除具有匹配名称的多个配置文件。 - `interface` （可选）：命令列出 `show interface` 的无线接口的名称。如果提供，则仅从指定的接口中删除配置文件;否则，它将从所有无线接口中删除。
无线局域网 `disconnect`	断开设备与指定接口上的无线网络的连接。如果设备上有两个或多个可用接口，则需要该 `interface=` 参数。通配符可用于指定多个接口。
无线局域网 `dump`	创建包含当前上下文配置的脚本。该脚本可以保存到文件中，并在设置被更改或需要在另一个系统上复制时用于恢复设置。
无线局域网 `export`	将选定的 WLAN 配置文件导出到指定文件夹中的 XML 文件。每个导出的配置文件都保存为“接口 Name-Profile Name.xml”。 `hostednetworkprofile` - 将托管网络配置文件导出到 XML 文件。 `profile` - 将指定的配置文件导出到 XML 文件。 Options are: - `name`：指定要导出的配置文件名称。 - `folder`：指定导出的配置文件 XML 文件的目标文件夹。 - `interface`：指定与配置文件关联的网络接口。 - `key`：要以纯文本形式显示安全密钥，请使用 `key=clear`。、和`name`参数`folderinterface`是可选的。 - 如果指定，则 `name` 仅导出该配置文件;否则，将导出所有配置文件。 - 如果提供了，则 `folder` 它必须是现有的、可访问的本地文件夹（绝对路径或相对路径）。 “。” 引用当前目录， “..” 引用其父目录。不支持 UNC 路径。默认情况下，配置文件保存在当前目录中。 - 如果指定，则 `interface` 仅导出该接口上的配置文件;否则，将导出具有给定名称的所有配置文件。 - 如果参数 `key` 设置为纯文本，并且调用者是本地管理员，则 XML 文件将包含纯文本的密钥。否则，密钥将在输出文件中加密。
无线局域网 `IHV`	`startlogging` - 启动 Wi-Fi 独立硬件供应商（IHV）事件的详细日志记录。 `stoplogging` - 停止 Wi-Fi IHV 事件的详细日志记录。
无线局域网 `refresh`	刷新托管无线网络的设置。 `data` - 指示 WLAN 服务使用新的安全密钥更新托管网络。
无线局域网 `reportissues`	生成 WLAN 智能跟踪报告，以帮助诊断和报告无线网络问题。
无线局域网 `set allowexplicitcreds`	`allow` - 启用（`yes`）或禁用（`no`）对 WLAN 连接使用显式凭据。此参数是必需的。
无线局域网 `set autoconfig`	`enabled` - 将 WLAN 自动配置设置为打开（`yes`）或关闭（`no`）。 `interface` - 指定要配置的无线网络接口。如果设置，则 `enabled=no` Windows 不会从指定接口自动连接到任何无线网络。
无线局域网 `set blockednetworks`	`display` - 在网络列表中显示（`show`）或隐藏（`hide`）被阻止的无线网络。如果设置，则 `display=hide` 阻止的网络不会显示在可用无线网络列表中。
无线局域网 `set blockperiod`	`value` - 设置在连接尝试失败后阻止无线网络的时间段（以分钟为 `0` 单位，到 `60`）。当您手动尝试连接、用户会话更改或网络接口重新连接时，将清除阻止状态。
无线局域网 `set createalluserprofile`	`enabled` - 允许（`yes`）或禁止（`no`）创建所有用户无线配置文件。此参数是必需的。
无线局域网 `set hostednetwork`	`mode` - 启用（`allow`）或禁用（`disallow`）托管网络功能。 `ssid` - 设置托管网络的 SSID（网络名称）。 `key` - 指定托管网络的密码。用户安全密钥应为包含 8 到 63 个 ASCII 字符的字符串。 `keyUsage` - 确定键 `persistent` 是还是 `temporary`。如果设置为 `persistent`，则`keyUsage`安全密钥将保存并在将来启动托管网络时重复使用。如果设置为 `temporary`，则该密钥仅用于当前或下一个托管网络会话，并在托管网络停止时删除。如果未指定，则 `keyUsage` 键默认为 `persistent`。
无线局域网 `set profileorder`	设置特定接口的无线网络配置文件的首选项顺序。所有三个参数（`name` 、 `interface`和 `priority`）都是必需的。只有用户配置文件可以更改其顺序。组策略配置文件是只读的，并且始终优先于用户配置文件。该 `priority` 参数确定配置文件在首选用户配置文件列表中的新位置。例如，设置 `priority=1` 将配置文件移动到用户配置文件列表的顶部。 `name` - 指定无线配置文件的名称。 `interface` - 指定要应用配置文件顺序的无线网络接口。 `priority` - 设置配置文件的优先级（整数值）。
无线局域网 `profileparameter`	修改指定的配置文件。如果指定了接口，则只修改该接口上的配置文件。 `name` 参数是必需的。除了配置文件名称和接口之外，还必须至少指定一个其他参数。 `name`：指定无线配置文件的名称。 `interface`：指定无线网络接口。 `SSIDname`：指定配置文件的 SSID。 `ConnectionType` - 指定网络是基础设施（`ESS`）还是临时网络（`IBSS`）。 `ConnectionMode` - 将连接模式设置为自动（`auto`）或手动（`manual`）。对于临时（`IBSS`）网络，必须设置为。`manual` `autoSwitch` - 确定设备是否在可用时自动切换到更首选的网络（`yes` 或 `no`）。 `randomization` - 启用（`yes`）或禁用（`no`） MAC 地址随机化以保护隐私。如果设置，则 `daily` MAC 地址随机化每天刷新。 `nonBroadcast` - 指示是否连接到隐藏（非广播）网络（`yes` 或 `no`）。 `authentication` - 设置用于连接的身份验证方法： - `open`：无需认证（密码）。 - `shared`：共享 WEP 密钥身份验证。 - `WPA` - `WPA2` - `WPAPSK` - `WPA2PSK` `encryption` - 指定无线流量的加密协议（`WEP` 、 `TKIP`、 `AES`或 `none`）。 `keyType` - 定义共享密钥是 a `networkkey` 还是 `passphrase`. `keyIndex` - 选择用于加密 WEP 无线流量的密钥索引（`1` to `4`）。该值表示四个存储的 WEP 密钥之一。 `keyMaterial` - 指定网络密钥或密码。 `PMKCacheMode` - 启用（`yes`）或禁用（`no`） PMK 缓存（仅适用于 WPA2 网络）。 `PMKCacheSize` - 设置客户端 PMK 缓存中的条目数（`1` 至 `255`）。 `PMKCacheTTL` - 指定 PMK 缓存条目的保留时间（以秒（`300` 到 `86400`）为单位。 `preAuthMode` - 启用（`yes`）或禁用（`no`）预身份验证（仅适用于 WPA2 网络）。 `preAuthThrottle`- 将相邻接入点`116`上的预身份验证尝试次数设置为。 `FIPS` - 打开（`yes`） FIPS 模式或关闭（`no`）以增强安全合规性。 `useOneX` - 启用（`yes`）或禁用（`no`） 802.1X 身份验证。 `authMode` - 选择用于身份验证的凭据类型（`machineoruser`、 `machineonly`、 `useronly`或 `guest`）。 `ssoMode` - 指定要使用的单点登录模式（如果有`prelogon`）（、 `postlogon`或 `none`）。 `maxDelay` - 设置建立单点登录连接（`1` 到 `120`）允许的最长时间（以秒为单位）。 `allowDialog` - 在预登录期间允许（`allow`）或阻止（`no`）对话框提示。 `userVLAN`- 指示网络在用户身份验证`yesno`后是否切换到其他 VLAN（或）。 `heldPeriod` - 设置身份验证尝试之间的间隔（以秒（`1` 到 `3600`）为单位。 `AuthPeriod`- 客户端等待身份验证器响应的最长时间（以秒为`13600`单位）（到）。 `StartPeriod` - 发送 EAPOL-Start 消息之前等待的时间（以秒`1` 为 `3600`单位）（到）。 `maxStart` - 在身份验证 `1` 期间从到发送 `100`的最大 EAPOL-Start 消息数。 `maxAuthFailures`- 从到的`100`一组凭据`1`允许的最大身份验证失败次数。 `cacheUserData` - 启用（`yes`）或禁用（`no`）用户凭据的缓存以供将来使用。 `cost` - 设置网络配置文件的成本类别： - `default`：除非另有说明，否则将 Wi-Fi 视为非计量。 - `unrestricted`：将网络视为无限。 - `fixed`：将网络标记为具有固定数据限制的计量。 - `variable`：将网络标记为按流量计费，但假设成本或数据可用性可能会发生变化（漫游费用或动态定价）。
无线局域网 `set profiletype`	更改指定配置文件的配置文件类型。如果指定了接口，则仅更改该接口上的配置文件。需要 `name` 和 `profiletype` 参数。 `name` - 要更改的配置文件名称。 `profiletype`- 使用或 `current` 为`all`单个用户指定所需的配置文件类型。 `interface` - 指定设置配置文件的接口的名称。
无线局域网 `set randomization`	`enabled` - 启用（`yes`）或禁用（`no`） MAC 地址随机化。 `interface` - 指定无线网络接口。如果接口不支持随机化或系统管理员阻止随机化，则此命令将失败。这两个参数都是必需的。
无线局域网 `set tracing`	`mode` - 启用（`yes`）或禁用（`no`）跟踪，并可选择进行跟踪 `persistent`。如果启用，则会收集无线局域网的跟踪日志并将其保存到跟踪文件中。在持久模式下，系统重新启动后跟踪仍然有效。如果 mode 设置为 disable，则持久跟踪和非持久跟踪都会停止。
无线局域网 `show`	显示以下信息： `all` - 提供有关系统上所有无线设备和网络的详细信息。 `allowexplicitcreds` - 显示在无线连接中使用显式用户凭据的当前配置。 `autoconfig` - 是启用还是禁用自动无线网络配置。 `blockednetworks` - 显示被阻止的无线网络的当前可见性设置。 `createalluserprofile` - 如果允许用户创建可供所有用户使用的无线配置文件。 `drivers` - 列出已安装无线局域网驱动程序的属性和详细信息。 `filters` - 显示允许和阻止的无线网络的当前列表。 `hostednetwork` - 显示托管无线网络的状态和属性。 `interfaces` - 列出系统上检测到的所有无线局域网接口。 `networks` - 显示范围内所有可见的无线网络。 `onlyUseGPProfilesforAllowedNetworks` - 指示是否仅将组策略配置的配置文件用于允许的网络。 `profiles` - 列出所有已配置的无线网络配置文件。 `randomization` - 指示无线连接的 MAC 地址随机化状态。 `settings` - 显示无线局域网的全局配置设置。 `tracing` - 无线局域网跟踪当前是否处于活动状态。 `wirelesscapabilities` - 列出系统支持的无线特性和功能。 `wlanreport` - 生成总结最近无线网络会话和活动的报告。
无线局域网 `start hostednetwork`	在托管网络上启动 WLAN 服务。
无线局域网 `stop hostednetwork`	停止托管网络上的 WLAN 服务。
`help`或`?`	显示当前上下文中的命令及其描述的列表。

Examples

要添加仅允许连接到特定网络 SSID 的 Wi-Fi 配置文件过滤器，请运行以下命令：

netsh wlan add filter permission=allow ssid="MyNetwork" networktype=infrastructure

要使用“Wi-Fi”接口连接到名为“CorpWiFi”的 Wi-Fi 网络，请运行以下命令：

netsh wlan connect name=CorpWiFi interface="Wi-Fi"

要断开与接口“Wi-Fi”上的 Wi-Fi 网络的连接，请运行以下命令：

netsh wlan disconnect interface="Wi-Fi"

若要将名为“CorpWiFi”的 Wi-Fi 配置文件导出到包含安全密钥的文件夹“C：\WiFiProfiles”，请运行以下命令：

netsh wlan export profile name="CorpWiFi" folder="C:\WiFiProfiles" key=clear

若要开始记录与 WLAN 相关的 IHV 事件，请运行以下命令：

netsh wlan IHV startlogging

若要刷新托管网络并更新其密钥或密码，请运行以下命令：

netsh wlan refresh hostednetwork data=MyKey

要将 SSID 名称设置为“CorpWiFi_5G”，并将连接模式设置为 Wi-Fi 自动 file 在“Wi-Fi”接口上“CorpWiFi”，运行以下命令：

netsh wlan set profileparameter name="CorpWiFi" interface="Wi-Fi" SSIDname="CorpWiFi_5G" ConnectionMode=auto

要设置所有配置文件的配置文件类型 Wi-Fi 配置文件 “CorpWiFi” 在接口“Wi-Fi”上，运行以下命令：

netsh wlan set profiletype name="CorpWiFi" profiletype=all interface="Wi-Fi"

要在持久模式下启用 WLAN 跟踪，请运行以下命令：

netsh wlan set tracing mode=persistent

反馈

此页面是否有帮助？

Last updated on 2025-10-09

通过

netsh wlan

Syntax

Parameters

Examples

See also

反馈

其他资源