用于无线局域网 (WLAN) 的 Netsh 命令针对运行 Windows Vista 和 Windows Server 2008 的计算机提供了配置 802.11 无线连接和安全设置的方法。可以使用 Netsh WLAN 命令来配置本地计算机，或使用登录脚本配置多台计算机。还可以使用 netsh WLAN 命令查看应用的无线组策略设置。

无线网络 (IEEE 802.11) 策略配置文件为只读，因此无法使用 Netsh WLAN 命令进行修改或删除。

在运行 Windows Server2008 的计算机上运行 Netsh wlan 命令

若要在运行 Windows Server 2008 的计算机上运行 Netsh WLAN 命令，必须首先安装“无线 LAN 服务”。

备注
在运行 Windows Server 2008 的计算机上，安装“服务器管理器”/“功能”中的“无线 LAN 服务”，然后添加并启动“WLAN 自动配置”服务。“WLAN 自动配置”位于“服务器管理器”/“诊断”/“服务”Microsoft 管理控制台 (MMC) 中。若要从运行 Windows Server 2008 的计算机上删除“WLAN 自动配置”服务，必须从“服务器管理器”/“功能”中删除（卸载）“无线 LAN 服务”。

在运行 Windows Server 2008 的计算机上安装“无线 LAN 服务”的步骤

  1. 执行下列操作之一：

    1. 在“初始配置任务”的“自定义此服务器”中，单击“添加功能”。此时会打开“添加功能向导”。

    2. 单击“开始”，然后单击“服务器管理器”。在“服务器管理器”的左窗格中，单击“功能”，在细节窗格的“功能摘要”中，单击“添加功能”。此时会打开“添加功能向导”。

  2. 在“选择功能”的“功能”中，向下滚动该列表，选择“无线 LAN 服务”，然后单击“下一步”。

  3. 在“确认安装选项”中，单击“安装”。

  4. 在“安装结果”中，查看安装结果，然后单击“关闭”。

Netsh WLAN 命令

此部分包含以下 Netsh WLAN 命令：

  • add filter

  • add profile

  • connect

  • delete filter

  • delete profile

  • disconnect

  • export profile

  • set autoconfig

  • set blockednetworks

  • set createalluserprofile

  • set profileorder

  • set profileparameter

  • set tracing

  • show all

  • show autoconfig

  • show blockednetworks

  • show drivers

  • show filters

  • show interfaces

  • show networks

  • show profiles

  • show settings

  • show tracing

add filter

按服务集标识符 (SSID) 向无线允许或阻止列表中添加无线网络。

语法

add filter permission={allow|block|denyall} ssid=WirelessNetworkNamenetworktype={infrastructure|adhoc}

参数
Permission
必需。指定筛选器的权限类型。
SSID
必需 [有关条件，请参阅“备注”]。无线网络的 SSID。
Networktype
必需。指定无线网络类型。
备注

如果 permission 为 allow 或 block，则 ssid 参数是必需的。如果 permission 为 denyall，则不指定 ssid 参数。

示例命令

  • add filter permission=allow ssid=WiFiNetwork networktype=infrastructure

  • add filter permission=block ssid="Wireless Net" networktype=adhoc

  • add filter permission=denyall networktype=infrastructure

add profile

向计算机的指定接口中添加 WLAN 配置文件。

语法

add profile filename=PathAndFileName [[interface=]InterfaceName] [[user=]{all|current}]

参数
Filename
必需。指定包含配置文件数据的 XML 文件的路径和名称。
Interface
可选。指定要向其中添加配置文件的无线接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
User
可选。指定是将配置文件仅应用于当前用户还是应用于所有用户。
备注

interface 参数是由 netsh wlan show interface 命令显示的其中一个接口名称。如果指定了 interface 参数，则将配置文件添加到指定的接口中。如果未指定 interface 参数，则在所有无线接口上添加配置文件。此参数支持使用通配符。可以使用字符 ? 和 * 分别替换接口名称中的一个字母和多个字母。

如果未指定 user 参数，则将配置文件应用于所有用户。

示例命令

  • add profile filename=C:\Users\WirelessUser\Documents\profile1.xml interface="Wireless Network Connection"

  • add profile filename="C:\Wireless Profiles\WiFi Profile.xml" interface=w*

connect

使用指定的参数连接到无线网络。

语法

connect [[ssid=]WirelessNetworkName] name=ProfileNameinterface=InterfaceName

参数
SSID
可选 [有关条件，请参阅“备注”]。指定无线网络的 SSID。
Name
必需。指定用于连接尝试的无线配置文件的名称（其中 ProfileName 是 “管理无线网络”中所显示或通过 netsh wlan show profiles 命令所呈现无线配置文件的名称）。
Interface
必需 [有关条件，请参阅“备注”]。指定用于连接尝试的无线接口（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

如果配置文件中仅指定一个 SSID，则使用指定的 SSID 进行连接，并且 ssid 参数不是必需的。如果配置文件指定了多个 SSID，则 ssid 参数是必需的。

仅当计算机上存在多个无线接口时，interface 参数才是必需的。不能使用通配符 (*) 名称来指定接口名称。

如果指定的接口已经连接到无线网络，则该命令将断开接口与该网络的连接，然后尝试连接到新的网络。如果此命令尝试将网络连接到已经连接的接口，则此命令返回一条表明连接成功的消息，并且不更改无线适配器的状态。

示例

  • connect ssid=WiFiNetwork name=Profile1

  • connect ssid="Wireless Net" name=Profile2 interface="Wireless Network Connection"

delete filter

从无线允许或阻止列表中删除无线网络。

语法

deletefilterpermission={allow|block|denyall} ssid=WirelessNetworkNamenetworktype={infrastructure|adhoc}]

参数
Permission
必需。指定筛选器的权限类型。
SSID
必需 [有关条件，请参阅“备注”]。指定无线网络的 SSID。
Networktype
必需。指定无线网络类型是临时还是基础结构。
备注

除非 permission 参数的值为 denyall，否则 ssid 参数是必需的。如果 permission 参数为 denyall，则不应给定 ssid 参数。

示例命令

  • delete filter permission=allow ssid=WiFiNetwork networktype=infrastructure

  • delete filter permission=block ssid="Wireless Net" networktype=adhoc

  • delete filter permission=denyall networktype=adhoc

delete profile

从一个或多个接口中删除 WLAN 配置文件。

语法

deleteprofilename=ProfileName [[interface=]InterfaceName]

参数
Name
必需。指定要删除的无线配置文件的名称（其中 ProfileName 是 “管理无线网络”中所显示或通过 netsh wlan show profiles 命令所呈现无线配置文件的名称）。
Interface
可选。指定要在其上删除配置文件的无线接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

如果指定了 interface 参数，则仅从指定的接口中删除配置文件。

如果未指定 interface 参数，则从计算机上的所有接口中删除配置文件。

name 参数可以使用通配符字符；如果多个配置文件的名称与通配符匹配，则删除所有这些配置文件。可以使用字符 ? 和 * 分别替换接口名称中的一个字母和多个字母。

示例命令

  • delete profile name="Profile 1" interface="Wireless Network Connection"

  • delete profile name=Profile2 interface=*

  • delete profile name="Profile 1" i=*

disconnect

断开指定接口与无线网络的连接。

语法

disconnectinterface=InterfaceName

参数
Interface
必需 [有关条件，请参阅“备注”]。指定用于断开连接尝试的无线接口（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

如果计算机上存在多个无线接口，则 interface 参数是必需的。可以在接口名称中使用通配符 (*) 字符以指定多个接口。

如果指定的接口尚未连接到无线网络，则此命令返回一条表明断开连接成功的消息；不更改无线适配器的状态。

示例命令

  • disconnect

  • disconnect interface="Wireless Network Connection"

export profile

将 WLAN 配置文件另存为到指定位置的 XML 文件。

语法

exportprofilefolder=PathAndFileName [[name=]ProfileName] [[interface=]InterfaceName]

参数
Folder
可选。指定要保存的配置文件 XML 文件的路径和文件，以及已保存文件使用的名称。
Name
可选。指定要导出的无线配置文件的名称。无线配置文件的名称（其中 ProfileName 是 “管理无线网络”中所显示或通过 netsh wlan show profiles 命令所呈现无线配置文件的名称）。
Interface
可选。指定要在其上配置配置文件的无线接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

folder 参数必须指定可以从本地计算机访问的现有文件夹。可以是到当前工作目录的绝对路径，也可以是相对路径。此外，“.”指当前工作目录，并且“.”指当前工作目录的父目录。文件夹名称不可以是通用命名约定 (UNC) 路径。

如果指定了 name 参数，但没有指定 interface 参数，则只保存该配置文件。否则，将保存计算机上具有指定名称的所有配置文件。

如果指定了 interface 参数和 name 参数，则只保存该接口的指定配置文件。

指定接口的配置文件采用“InterfaceName ProfileName.xml”文件名格式保存。计算机级别的配置文件采用“ProfileName.xml”文件名格式保存。

示例命令

  • export profile folder=c:\profiles name="Profile 1" interface="Wireless Network Connection"

  • export profile folder="c:\wifi profiles" name=Profile2 interface=*

set autoconfig

启用或禁用接口上的 WLAN 自动配置服务。

语法

setautoconfigenabled={yes|no} interface=InterfaceName

参数
enabled
必需。指定将 WLAN 自动配置服务设置为启用还是禁用。
Interface
必需。指定已在其上启用或禁用此服务的接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

启用 WLAN 自动配置服务时，运行 Windows Vista 和 Windows Server 2008 的计算机会自动使用指定的接口连接到无线网络。默认情况下，在运行 Windows Vista 的计算机上启用自动配置。

如果禁用自动配置，则 Windows 将不会使用指定的接口自动连接到任何无线网络。

interface 参数支持使用通配符。可以使用字符 ? 和 * 分别替换接口名称中的一个字母和多个字母。

示例命令

  • set autoconfig enabled=yes interface="Wireless Network Connection"

set blockednetworks

在可见网络列表中，显示或隐藏被阻止的网络。

语法

setblockednetworksdisplay={show|hide}

参数
Display
必需。指定在可用的无线网络列表中显示还是隐藏被阻止的网络。请参阅“备注”。
备注

若要查看可用的无线网络的列表，请依次单击“开始”、“连接到”，然后打开“连接到网络”对话框。在“显示”中，选择“无线”以便仅显示无线网络。

示例命令

  • set blockednetworks display=show

此示例命令指定在可用网络的列表中显示被阻止的网络。

set createalluserprofile

指定是否允许用户创建所有用户配置文件（无论他们是否是 Administrators 组的成员）。在 Administrators 组中具有成员身份的用户可以创建所有用户配置文件（无论“set createalluserprofile enabled=”是设置为“yes”还是“no”）。

备注
只能在运行 Windows Vista（带有 Service Pack 1）和 Windows Server 2008 的计算机上使用 set createalluserprofile。
语法

setcreatealluserprofileenabled={yes|no}

参数
Enabled
必需。指定是否允许所有计算机用户创建所有用户配置文件。
备注

如果将 enabled 设置为 yes，则允许每个用户创建所有用户配置文件。如果将 enabled 设置为 no，则只允许具有管理员权限的用户创建所有用户配置文件。

示例命令

  • set createalluserprofile enabled=yes

set profileorder

设置无线网络接口上的无线网络配置文件的优先顺序。

语法

setprofileordername=ProfileNameinterface=InterfaceNamepriority=integer

参数
Name
必需。指定要设置的配置文件的名称（其中 ProfileName 是 “管理无线网络”中所显示或通过 netsh wlan show profiles 命令所呈现无线配置文件的名称）。
Interface
必需。指定已配置此配置文件的接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
Priority
必需。指定配置文件的新优先级数字。请参阅“备注”。
备注

如果将参数 priority 设置为 0 或 1，则将此配置文件移动到列表中的第一个位置，而无论另一个配置文件以前是否设置为 0 或 1 都是如此。较低的数字表示较高的优先级。对于计算机上配置文件的数量没有实际限制。

示例命令

  • set profileorder name="profile 1" interface="Wireless Network Connection" priority=1

set profileparameter

设置无线网络配置文件中的参数。

备注
只能在运行 Windows Vista（带有 Service Pack 1）和 Windows Server 2008 的计算机上使用 set profileparameter。
语法

set profileparametername=ProfileName [[interface=]InterfaceName] [[authMode=]{machineOrUser|machineOnly|userOnly|guest}] [[ssoMode=]{preLogon|postLogon|none}] [[maxDelay=]1-120] [[allowDialog={yes|no}] [[userVLAN=]{yes|no}] [[fips=]{yes|no}]

参数
Name
必需。指定要设置的配置文件的名称（其中 ProfileName 是 “管理无线网络”中所显示或通过 netsh wlan show profiles 命令所呈现无线配置文件的名称）。
Interface

  • 可选。指定要在其上设置配置文件的接口的名称（其中 InterfaceName 是“网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。

AuthMode
可选 [有关条件，请参阅“备注”]。指定用于身份验证的凭据类型。
SSOMode
可选 [有关条件，请参阅“备注”]。指定尝试的单一登录的类型（如果有）。
MaxDelay
可选 [有关条件，请参阅“备注”]。指定建立单一登录连接的超时值。
AllowDialog
可选 [有关条件，请参阅“备注”]。指定是允许还是禁止为预登录显示对话框。
UserVLAN
可选 [有关条件，请参阅“备注”]。指定进行用户身份验证时是否将网络切换到其他 VLAN。
FIPS
可选 [有关条件，请参阅“备注”]。指定是启用还是禁用联邦信息处理标准出版物 (FIPS) 模式。
备注

参数 name 是必需的；但无论是否指定了参数 interface，所有其他参数都是可选的，并且必须至少指定一个其他参数。

如果指定了 interface 参数，则仅修改与该接口关联的配置文件。

示例命令

  • set profileparameter name="Profile 1" authMode=userOnly ssoMode=preLogon

  • set profileparameter name=Profile2 ssoMode=none fips=yes

set tracing

启用或禁用 WLAN 跟踪。

语法

set tracingmode={yes|no|persistent}

参数
Mode
必需。指定是禁用跟踪、启用且持久跟踪还是启用但非持久跟踪。有关其他信息，请参阅“备注”。
备注

如果将 mode 参数设置为 yes，则在将 mode 设置为 no 或重新启动计算机之前，非持久跟踪将一直处于活动状态。

如果将 mode 参数设置为 no，则停止持久跟踪或非持久跟踪。

如果将 mode 参数设置为 persistent，则跟踪处于活动状态，即使重新启动计算机之后也是如此。

mode 参数的默认值为 nonpersistent。

示例命令

  • settracingmode=persistent

show all

显示有关无线网络适配器、无线配置文件和无线网络的整个信息集合。

语法

show all

参数

该命令没有参数。

备注

显示系统上的 802.11 无线接口信息、网络信息和无线设置的整个集合，包括：

  • 无线适配器驱动程序信息

  • 无线接口状态

  • 无线配置设置

  • 无线网络筛选器

  • 无线网络配置文件列表和详细信息

  • 可见的无线网络

示例命令

  • show all

show autoconfig

显示是启用还是禁用 WLAN 自动配置服务

语法

showautoconfig

参数

该命令没有参数。

备注

显示在每个无线适配器接口上是启用还是禁用 WLAN 自动配置服务。

示例命令

  • show autoconfig

show blockednetworks

显示在可见网络列表中全局设置是显示还是隐藏被阻止的网络

语法

showblockednetworks

参数

该命令没有参数。

备注

显示在可见网络列表中全局设置是显示还是隐藏被阻止的网络。

示例命令

  • show blockednetworks

show drivers

显示计算机上无线适配器驱动程序的属性。

语法

showdrivers [[interface=]InterfaceName]

参数
Interface
可选。指定显示驱动程序信息的接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

显示 802.11 无线 LAN 接口驱动程序信息。

以下列表概述了该命令展示的信息类型：

  • 接口名称（无线网络连接）

  • 驱动程序（型号和类型）

  • 供应商（制造商名称）

  • 提供商（驱动程序提供商）

  • 日期（编写驱动程序的日期）

  • 版本（驱动程序版本号）

  • INF 文件（驱动程序 INF 文件的位置）

  • 类型（本机 Wi-Fi 驱动程序或旧 Wi-Fi 驱动程序）

  • 支持的无线电类型（直接序列扩频 [DSSS]、802.11g、802.11b）

  • 基础结构模式中支持的身份验证和密码（WPA2-企业 TKIP；CCMP，Wi-Fi 安全访问 [WPA]-企业暂时密钥完整性协议 [TKIP]；CCMP，WPA2-个人 TKIP；CCMP，WPA-个人 TKIP；CCMP，Open 有线等效保密 [WEP]，Open None，Shared WEP，Shared None）

  • 临时模式中支持的身份验证（Open-WEP、Open-None、Shared WEP）

示例命令

  • show drivers interface="Wireless Network Connection"

show filters

显示允许和阻止的无线网络的当前列表。

语法

showfilters [[permission=]{allow|block}]

参数
Permission
可选。指定是否显示计算机上配置的允许和阻止的网络列表。
备注

如果指定了参数 permission，则此命令显示系统上配置的具有指定权限类型（allow 或 block）的网络列表。否则，显示允许和阻止的列表。

示例命令

  • show filters

  • show filters permission=allow

  • show filters permission=block

show interfaces

显示计算机上一系列当前无线接口。

语法

showinterfaces

参数

该命令没有参数。

备注

显示计算机上配置的无线接口。

显示的信息包括：

  • 计算机上接口的数量

  • 名称（例如“无线网络连接”）

  • 描述（例如，Broadcom 802.11g 网络适配器）

  • GUID（十六进制字符串）

  • 接口状态（已连接或已断开连接）

示例命令

  • show interfaces

show networks

显示计算机上一系列可见的无线网络。

语法

shownetworks [[interface=]InterfaceName] [[mode=]{ssid|bssid}]

参数
Interface
可选。指定返回网络信息的接口（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
Mode
可选。指定是否显示基本服务集标识符 (BSSID) 或服务集标识符 (SSID) 的信息。
备注

显示计算机可用的无线网络。

如果指定了 interface 参数，则仅列出指定接口可见的网络。否则，将列出此计算机可见的所有网络。

如果指定了 mode=ssid 参数，则列出有关每个可见的 SSID 的信息。

显示的 SSID 信息包括：

  • 接口名称

  • 可见网络的数量

  • 网络名称，按 SSID

  • 网络类型（基础结构或临时）

  • 身份验证（在无线配置文件的属性中，称为“安全类型”。安全类型包括 WPA2-企业、WPA2-个人、WPA-企业、WPA-个人、WEP 和 Open。）

  • 加密方法 [示例包括高级加密标准 (AES) 和暂时密钥完整性协议 (TKIP)]。

  • 无论是否指定了 mode 参数，都仅列出 SSID。

显示的 SSID 信息包括：

  • 接口名称

  • 可见网络的数量。

  • 网络名称，按 SSID

  • 网络类型（基础结构或临时）

  • 身份验证（访问点 - 网络身份验证）

  • 加密方法

如果指定了 mode=bssid 参数，则列出每个可见 SSID 的可见 BSSID 信息。

显示的 BSSID 信息包括：

  • 接口名称

  • 可见网络的数量

  • 网络名称，按 SSID

  • 网络类型（基础结构或临时）

  • 身份验证（在无线配置文件的属性中，称为“安全类型”。安全类型包括 WPA2-企业、WPA2-个人、WPA-企业、WPA-个人、WEP 和 Open。）

  • 加密方法（示例包括 AES 和 TKIP）

  • BSSID 号（例如，00:54:96:32:06）

    • 信号强度（按 %）

    • 无线电类型（例如，802.11b）

    • 频道（无线电频道号）


示例命令

  • show networks interface="Wireless Network Connection"

  • show networks mode=bssid

  • show networks

show profiles

显示计算机上配置的一系列无线配置文件。

语法

showprofiles [[name=]ProfileName] [[interface=]InterfaceName]

参数
Name
可选。指定要显示的配置文件的名称（其中 ProfileName 是 “管理无线网络”中所显示或通过 netsh wlan show profiles 命令所呈现无线配置文件的名称）。
Interface
可选。指定已配置此配置文件的接口的名称（其中 InterfaceName 是 “网络连接”中所显示或通过 netsh wlan show interfaces 命令所呈现无线接口的名称）。
备注

显示计算机上的配置文件数据或列出配置文件。

如果指定了 name 参数，则仅显示指定配置文件的内容。如果未指定 name 参数，则仅显示配置文件名称和描述。

如果指定了 interface 参数，则仅显示指定接口上的配置文件。如果未指定 interface 参数，则显示具有指定名称的所有配置文件。

显示的信息包括：

  • 所有用户或当前用户配置文件

  • 配置文件名称

  • 应用的配置文件（当前用户或所有用户）

  • 控制选项

    • 自动连接或手动连接

    • 显示 SSID 或隐藏 SSID


  • 连接设置：

    • SSID 号（按号加 SSID 列出）

    • 网络类型（基础结构或临时）

    • 无线电类型

    • 供应商扩展

  • 安全设置

    • 身份验证/密码组合数（例如，auth: WPA2-Enterprise、cipher: TKIP）

    • 安全密钥

    • 802.1X（启用或禁用）

    • 可扩展的身份验证协议 (EAP) 类型

    • 802.1X 身份验证凭据

    • 缓存用户信息

示例命令

  • show profiles name="profile 1" interface="Wireless Network Connection"

  • show profiles name=profile2

  • show profiles

show settings

显示无线 LAN 的当前全局设置。

语法

showsettings

参数

该命令没有参数。

备注

显示无线网络服务的全局设置，其中包括是否在每个接口上启用了 WLAN 自动配置服务以及是显示还是隐藏被阻止的网络。

可以使用 show filters 命令获得允许和阻止筛选器列表。

示例命令

  • show settings

show tracing

显示是启用还是禁用无线跟踪。

语法

showtracing

参数

该命令没有参数。

备注

显示的信息包括：

  • 跟踪状态（已启用或已禁用）

  • 跟踪持久状态（正在运行或未运行）

  • 跟踪日志文件位置（例如，“c:\Windows\system32\logfiles\WirelessAutoLog\”）

示例命令

  • show tracing