WLANProfile-Element

Artikel
06/26/2023

Das WLANProfile-Element enthält ein WLAN-Profil. Dieses Element ist das eindeutige Stammelement für ein Drahtlosprofil.

Der Zielnamespace für das WLANProfile-Element ist 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>

Übergeordnete Elemente

Keine.

Untergeordnete Elemente

Element	type	BESCHREIBUNG
name	nameType	Name des WLAN-Profils.
SSIDConfig		Enthält mindestens eine SSIDs für drahtlose LANs.
Hotspot2		Erweitert das WLAN-Profilschema v1, um Hotspot 2.0-Netzwerke zu unterstützen.
connectionType		Gibt an, ob es sich bei dem Netzwerk um eine Infrastruktur ("ESS") oder ad-hoc ("IBSS") handelt.
connectionMode		Gibt an, ob die Verbindung mit dem WLAN automatisch ("automatisch") oder vom Benutzer initiiert ("manuell") erfolgen soll. Dieses Element ist optional.
autoSwitch	boolean	Bestimmt das Roamingverhalten eines automatisch verbundenen Netzwerks, wenn sich ein bevorzugtes Netzwerk im Bereich befindet. Dieses Element ist optional und hat keine Auswirkungen auf ein manuell verbundenes Netzwerk.
MSM		Enthält verschiedene MSM-Einstellungen (Media-Specific Module).
IHV		Enthält verschiedene Einstellungen für unabhängige Hardwareanbieter.
MacRandomization		Konfiguriert die Zufälligkeit von MAC-Adressen.

name

Enthält den Namen eines WLAN-Profils.

Bei einem Namen wird die Groß-/Kleinschreibung beachtet.

Für Windows XP mit Service Pack 3 (SP3) und die WLAN-API für Windows XP mit Service Pack 2 (SP2) wird das Namenselement ignoriert, wenn das Profil im Profilspeicher gespeichert wird. Der Name des Profils wird von der SSID des Netzwerks abgeleitet. Bei Infrastrukturnetzwerkprofilen ist der Name des Profils die SSID des Netzwerks. Bei Ad-hoc-Netzwerkprofilen ist der Name des Profils die SSID des Ad-hoc-Netzwerks gefolgt von -adhoc. XML-Escapezeichen, z &. B. , werden nicht angezeigt. Vermeiden Sie die Verwendung von XML-Escapezeichen in SSID-Namen für Profile, die unter Windows XP mit SP3 oder wireless LAN API für Windows XP mit SP2 bereitgestellt werden.

Für jedes Netzwerkprofil, das nur unter Windows Vista oder Windows Server 2008 verwendet werden soll, kann der Name eine beliebige Zeichenfolge sein.

connectionType

Das connectionType-Element gibt den Betriebsmodus des Netzwerks an. Der Wert ESS gibt ein Infrastrukturnetzwerk an, während IBSS ein Ad-hoc-Netzwerk angibt.

connectionMode

Das connectionMode -Element (WLANProfile) gibt an, ob die Verbindung mit einem WLAN automatisch oder vom Benutzer initiiert werden soll.

Wenn connectionType auf ESS festgelegt ist, kann dieser Wert entweder automatisch oder manuell sein. Der Standardwert ist automatisch, wenn dieses Element nicht vorhanden ist.

Wenn connectionType auf IBSS festgelegt ist, muss dieser Wert manuell sein.

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

In der folgenden Tabelle werden die Enumerationswerte beschrieben.

Wert	BESCHREIBUNG
auto	Die Verbindung mit dem Drahtlosnetzwerk sollte automatisch initiiert werden, wenn sich das Netzwerk in Reichweite befindet.
manual	Die Verbindung mit dem Drahtlosen Netzwerk wird nur auf explizite Anforderung eines Benutzers initiert.

autoSwitch

Bestimmt das Roamingverhalten eines automatisch verbundenen Netzwerks, wenn sich ein bevorzugtes Netzwerk im Bereich befindet. Dieses Element ist optional.

Wenn autoSwitch auf "true" festgelegt ist und connectionMode auf "auto" festgelegt ist, muss eine Verbindung mit einem bevorzugten Netzwerk versucht werden, wenn ein bevorzugtes Netzwerk in den Bereich kommt. Ein bevorzugtes Netzwerk ist eines, das in der Liste der bevorzugten drahtlosen Netzwerke höher sortiert ist. Dieser Verbindungsversuch tritt auf, wenn eine Verbindung mit einem anderen Netzwerk hergestellt wird.

Wenn connectionMode auf "auto" festgelegt ist, kann dieser Wert entweder "true" oder "false" lauten.

Wenn connectionMode auf "manual" festgelegt ist, muss dieser Wert auf "false" festgelegt werden. Dieses Element hat keine Auswirkungen auf ein manuell verbundenes Netzwerk.

Ein autoSwitch-Wert, der auf "true" festgelegt ist, führt zu einer höheren Häufigkeit regelmäßiger Überprüfungen für neue Netzwerke. Dies kann zu einer erhöhten Radiofrequenzverschmutzung durch diese regelmäßigen Überprüfungen und zu einem erhöhten Stromverbrauch führen, der vom Drahtlosen Netzwerkadapter verwendet wird.

Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst: Änderungen werden unter Windows 7 und Windows Server 2008 R2 implementiert, wobei der Wlan-Dienst installiert ist, um die Leistung von Drahtlosnetzwerken zu optimieren. Diese Änderungen wurden entwickelt, um die Verschmutzung von Funkfrequenzen, den Stromverbrauch und die Unterbrechung des Echtzeitdatenverkehrs über drahtlose Netzwerke zu reduzieren. Die Standardeinstellung für autoSwitch , wenn dieses Element in einem WLAN-Profil nicht festgelegt ist, wurde geändert. Die Standardeinstellung wird unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst in "false" geändert. Die Standardeinstellung war "true" unter Windows Server 2008 und Windows Vista. Es wird empfohlen, den Wert des autoSwitch-Elements , das von einer Anwendung in einem WLAN-Profil verwendet wird, auf "false" festzulegen, um die Häufigkeit regelmäßiger Überprüfungen für neue Netzwerke zu reduzieren, es sei denn, es ist absolut erforderlich, dass eine Anwendung diesen Wert auf "true" festlegt.

Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.

Bemerkungen

Die meisten untergeordneten Elemente des WLANProfile-Elements befinden sich im https://www.microsoft.com/networking/WLAN/profile/v1 Namespace. Es gibt zwei Ausnahmen: Das FIPSMode-Element befindet sich im https://www.microsoft.com/networking/WLAN/profile/v2 Namespace und das OneX-Element befindet sich im https://www.microsoft.com/networking/OneX/v1 Namespace.

Informationen zum Anzeigen der Liste der untergeordneten Elemente in einer strukturähnlichen Struktur finden Sie unter WLAN_profile Schemaelemente.

Beispiele

Beispielprofile finden Sie unter Beispiele für Drahtlosprofil.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Verteilbare Komponente	Wlan-API für Windows XP mit SP2

Freigeben über