WLANProfile 元素

發行項
01/10/2024

WLANProfile 元素包含無線 LAN 配置檔。這個專案是無線配置檔的唯一根元素。

WLANProfile 項目的目標命名空間為 https://www.microsoft.com/networking/WLAN/profile/v1。

<xs:element name="WLANProfile">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="name"
                type="nameType"
             />
            <xs:element name="SSIDConfig"
                maxOccurs="256"
                ...
             />
            <xs:element name="Hotspot2"
                minOccurs="0"
                ...
             />
            <xs:element name="connectionType">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="IBSS">
                        <xs:enumeration value="ESS">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="connectionMode"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="auto">
                        <xs:enumeration value="manual">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="autoSwitch"
                minOccurs="0"
                type="boolean"
             />
            <xs:element name="MSM"
                minOccurs="0"
                ...
             />
            <xs:element name="IHV"
                minOccurs="0"
                ...
             />
            <xs:element name="MacRandomization"
                ...
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

父元素

無。

子元素

元素	類型	Description
name	nameType	WLAN 配置檔的名稱。
SSIDConfig		包含一或多個無線 LAN 的 SSID。
Hotspot2		擴充 WLAN 配置檔架構 v1 以支持熱點 2.0 網路。
connectionType		指出網路是否為基礎結構（“ESS”）或臨機操作（“IBSS” ）。
connectionMode		指出與無線 LAN 的連線是否應由使用者自動或起始（“manual”）。這是選擇性的項目。
autoSwitch	boolean	當更慣用的網路處於範圍內時，決定自動連線網路的漫遊行為。這個元素是選擇性的，而且對手動聯機的網路沒有任何作用。
Msm		包含各種媒體特定模組（MSM）設定。
IHV		包含獨立硬體廠商的各種設定。
MacRandomization		設定 MAC 位址的隨機化。

NAME

包含無線 LAN 設定檔的名稱。

名稱會區分大小寫。

針對 Windows XP 搭配 Service Pack 3 （SP3）和 Windows XP Service Pack 2 的無線 LAN API（SP2），配置檔 儲存在配置檔存放區時，會忽略 name 元素。配置檔的名稱衍生自網路的 SSID。針對基礎結構網路配置檔，配置檔的名稱是網路的 SSID。針對臨機操作網路配置檔，配置檔的名稱是臨機操作網路的 SSID， -adhoc後面接著。不會顯示 XML 逸出字元，例如 & 。請避免在 SSID 名稱中使用 XML 逸出字元，以使用 SP3 部署在 Windows XP 上的設定檔，或搭配 SP2 使用 Windows XP 的無線 LAN API。

針對任何僅供 Windows Vista 或 Windows Server 2008 使用的網路配置檔，名稱可以是任何字串。

connectionType

connectionType 元素表示網路的作業模式。 ESS 的值表示基礎結構網路，而 IBSS 則表示臨機操作網路。

connectionMode

connectionMode （WLANProfile）元素會指出使用者是否應該自動或起始與無線 LAN 的連線。

如果 connectionType 設定為 ESS，此值可以是自動或手動值。如果這個專案不存在，則預設值為 auto。

如果 connectionType 設定為 IBSS，這個值必須是手動的。

<xs:element name="connectionMode">
    <xs:simpleType>
        <xs:restriction
            base="string"
        >
            <xs:enumeration
                value="auto"
             />
            <xs:enumeration
                value="manual"
             />
        </xs:restriction>
    </xs:simpleType>
</xs:element>

下表描述列舉值。

值	描述
自動	每當網路處於範圍內時，應該自動起始與無線網路的連線。
manual	與無線網路的連線只會在用戶的明確要求時進行初始化。

autoSwitch

當更慣用的網路處於範圍內時，決定自動連線網路的漫遊行為。這是選擇性的項目。

如果 autoSwitch 為 “true”，且 connectionMode 設定為 “auto”，則每當更慣用的網络進入範圍時，就必須嘗試連線至較慣用的網络。較慣用的網路是在慣用無線網路清單中排序較高的網路。線上至另一個網路時，會發生此連線嘗試。

如果 connectionMode 設定為 “auto”，這個值可以是 “true” 或 “false”。

如果 connectionMode 設定為 “manual”，此值必須設定為 “false”。此元素不會影響手動連線的網路。

設定為「true」的 autoSwitch 值會導致新網路的定期掃描頻率較高。這可能會導致這些定期掃描的無線電頻率污染增加，以及無線網路適配卡所使用的耗電量增加。

已安裝無線 LAN 服務的 Windows 7 和 Windows Server 2008 R2： 在已安裝無線 LAN 服務的 Windows 7 和 Windows Server 2008 R2 上實作變更，以優化無線網路效能。這些變更的設計目的是降低無線網路上即時流量的無線電頻率污染、耗電量和中斷。未在無線 LAN 設定檔中設定這個專案時，autoSwitch 的預設設定已變更。在已安裝無線 LAN 服務的 Windows 7 和 Windows Server 2008 R2 上，預設設定會變更為 “false”。 Windows Server 2008 和 Windows Vista 上的預設設定為 “true”。建議將無線 LAN 設定檔中應用程式所使用的 autoSwitch 元素值設定為「false」，以減少定期掃描新網路的頻率，除非應用程式將此值設定為「true」絕對必要。

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2： 不支援此元素。

備註

WLANProfile 元素的大部分子元素都在命名空間中 https://www.microsoft.com/networking/WLAN/profile/v1 。有兩個例外狀況：FIPSMode 元素位於 https://www.microsoft.com/networking/WLAN/profile/v2 命名空間中，而 OneX 元素位於命名空間中。https://www.microsoft.com/networking/OneX/v1

若要檢視類似樹狀結構中的子元素清單，請參閱架構元素WLAN_profile。

範例

若要檢視範例配置檔，請參閱無線配置檔範例。

需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
可轉散發套件	Windows XP 與 SP2 的無線 LAN API

共用方式為