WLANProfile-Element

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:complexType>
                    <xs:sequence>
                        <xs:element name="SSID"
                            maxOccurs="256"
                        >
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="hex"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="hexBinary"
                                            >
                                                <xs:minLength
                                                    value="1"
                                                 />
                                                <xs:maxLength
                                                    value="32"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="name"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="string"
                                            >
                                                <xs:minLength
                                                    value="1"
                                                 />
                                                <xs:maxLength
                                                    value="32"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:any
                                        processContents="lax"
                                        minOccurs="0"
                                        maxOccurs="unbounded"
                                        namespace="##other"
                                     />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="nonBroadcast"
                            type="boolean"
                            minOccurs="0"
                         />
                        <xs:any
                            processContents="lax"
                            minOccurs="0"
                            maxOccurs="unbounded"
                            namespace="##other"
                         />
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="connectionType">
                <xs:simpleType>
                    <xs:restriction
                        base="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="string"
                    >
                        <xs:enumeration
                            value="auto"
                         />
                        <xs:enumeration
                            value="manual"
                         />
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="autoSwitch"
                type="boolean"
                minOccurs="0"
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
            <xs:element name="MSM"
                minOccurs="0"
            >
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="connectivity"
                            minOccurs="0"
                        >
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="phyType"
                                        minOccurs="0"
                                        maxOccurs="4"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="string"
                                            >
                                                <xs:enumeration
                                                    value="a"
                                                 />
                                                <xs:enumeration
                                                    value="b"
                                                 />
                                                <xs:enumeration
                                                    value="g"
                                                 />
                                                <xs:enumeration
                                                    value="n"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:any
                                        processContents="lax"
                                        minOccurs="0"
                                        maxOccurs="unbounded"
                                        namespace="##other"
                                     />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="security"
                            minOccurs="0"
                        >
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="authEncryption">
                                        <xs:complexType>
                                            <xs:sequence>
                                                <xs:element name="authentication">
                                                    <xs:simpleType>
                                                        <xs:restriction
                                                            base="string"
                                                        >
                                                            <xs:enumeration
                                                                value="open"
                                                             />
                                                            <xs:enumeration
                                                                value="shared"
                                                             />
                                                            <xs:enumeration
                                                                value="WPA"
                                                             />
                                                            <xs:enumeration
                                                                value="WPAPSK"
                                                             />
                                                            <xs:enumeration
                                                                value="WPA2"
                                                             />
                                                            <xs:enumeration
                                                                value="WPA2PSK"
                                                             />
                                                        </xs:restriction>
                                                    </xs:simpleType>
                                                </xs:element>
                                                <xs:element name="encryption">
                                                    <xs:simpleType>
                                                        <xs:restriction
                                                            base="string"
                                                        >
                                                            <xs:enumeration
                                                                value="none"
                                                             />
                                                            <xs:enumeration
                                                                value="WEP"
                                                             />
                                                            <xs:enumeration
                                                                value="TKIP"
                                                             />
                                                            <xs:enumeration
                                                                value="AES"
                                                             />
                                                        </xs:restriction>
                                                    </xs:simpleType>
                                                </xs:element>
                                                <xs:element name="useOneX"
                                                    type="boolean"
                                                    minOccurs="0"
                                                 />
                                                <xs:any
                                                    processContents="lax"
                                                    minOccurs="0"
                                                    maxOccurs="unbounded"
                                                    namespace="##other"
                                                 />
                                            </xs:sequence>
                                        </xs:complexType>
                                    </xs:element>
                                    <xs:element name="sharedKey"
                                        minOccurs="0"
                                    >
                                        <xs:complexType>
                                            <xs:sequence>
                                                <xs:element name="keyType">
                                                    <xs:simpleType>
                                                        <xs:restriction
                                                            base="string"
                                                        >
                                                            <xs:enumeration
                                                                value="networkKey"
                                                             />
                                                            <xs:enumeration
                                                                value="passPhrase"
                                                             />
                                                        </xs:restriction>
                                                    </xs:simpleType>
                                                </xs:element>
                                                <xs:element name="protected"
                                                    type="boolean"
                                                 />
                                                <xs:element name="keyMaterial"
                                                    type="string"
                                                 />
                                                <xs:any
                                                    processContents="lax"
                                                    minOccurs="0"
                                                    maxOccurs="unbounded"
                                                    namespace="##other"
                                                 />
                                            </xs:sequence>
                                        </xs:complexType>
                                    </xs:element>
                                    <xs:element name="keyIndex"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="integer"
                                            >
                                                <xs:minInclusive
                                                    value="0"
                                                 />
                                                <xs:maxInclusive
                                                    value="3"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="PMKCacheMode"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="string"
                                            >
                                                <xs:enumeration
                                                    value="disabled"
                                                 />
                                                <xs:enumeration
                                                    value="enabled"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="PMKCacheTTL"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="integer"
                                            >
                                                <xs:minInclusive
                                                    value="5"
                                                 />
                                                <xs:maxInclusive
                                                    value="1400"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="PMKCacheSize"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="integer"
                                            >
                                                <xs:minInclusive
                                                    value="1"
                                                 />
                                                <xs:maxInclusive
                                                    value="255"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="preAuthMode"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="string"
                                            >
                                                <xs:enumeration
                                                    value="disabled"
                                                 />
                                                <xs:enumeration
                                                    value="enabled"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="preAuthThrottle"
                                        minOccurs="0"
                                    >
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="integer"
                                            >
                                                <xs:minInclusive
                                                    value="1"
                                                 />
                                                <xs:maxInclusive
                                                    value="16"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:any
                                        processContents="lax"
                                        minOccurs="0"
                                        maxOccurs="unbounded"
                                        namespace="##other"
                                     />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:any
                            processContents="lax"
                            minOccurs="0"
                            maxOccurs="unbounded"
                            namespace="##other"
                         />
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="IHV"
                minOccurs="0"
            >
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="OUIHeader">
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="OUI">
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="hexBinary"
                                            >
                                                <xs:length
                                                    value="3"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:element name="type">
                                        <xs:simpleType>
                                            <xs:restriction
                                                base="hexBinary"
                                            >
                                                <xs:length
                                                    value="1"
                                                 />
                                            </xs:restriction>
                                        </xs:simpleType>
                                    </xs:element>
                                    <xs:any
                                        processContents="lax"
                                        minOccurs="0"
                                        maxOccurs="unbounded"
                                        namespace="##other"
                                     />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="connectivity"
                            minOccurs="0"
                        >
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:any
                                        processContents="lax"
                                        namespace="##other"
                                     />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="security"
                            minOccurs="0"
                        >
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:any
                                        processContents="lax"
                                        namespace="##other"
                                     />
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="useMSOneX"
                            type="boolean"
                            minOccurs="0"
                         />
                        <xs:any
                            processContents="lax"
                            minOccurs="0"
                            maxOccurs="unbounded"
                            namespace="##other"
                         />
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

Untergeordnete Elemente

Element type BESCHREIBUNG
authEncryption Gibt das Authentifizierungs- und Verschlüsselungspaar an, das für dieses Profil verwendet werden soll.
Authentifizierung Gibt die Authentifizierungsmethode an, die zum Herstellen einer Verbindung mit dem WLAN verwendet werden soll.
autoSwitch boolean Bestimmt das Roamingverhalten eines automatisch verbundenen Netzwerks, wenn sich ein bevorzugtes Netzwerk in Reichweite befindet. Dieses Element ist optional und hat keine Auswirkungen auf ein manuell verbundenes Netzwerk.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
connectionMode Gibt an, ob die Verbindung mit dem WLAN automatisch ("automatisch") oder vom Benutzer ("manuell") initiiert werden soll. Dieses Element ist optional.
connectionType Gibt an, ob das Netzwerk eine Infrastruktur ("ESS") oder ad-hoc ("IBSS") ist.
Verbindung Enthält verschiedene Konnektivitätseinstellungen. Dieses Element ist optional.
Verbindung Enthält IHV-bezogene Konnektivitätseinstellungen.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
Verschlüsselung Legt die Datenverschlüsselung fest, die zum Herstellen einer Verbindung mit dem WLAN verwendet werden soll.
Hex Enthält die SSID eines WLAN im Hexadezimalformat.
IHV Enthält optionale IHV-Einstellungen (Independent Hardware Vendor).
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
keyIndex Gibt an, welcher Schlüsselindex zum Verschlüsseln von Drahtlosdatenverkehr verwendet werden soll. Dies wird nur verwendet, wenn keyType auf "networkKey" festgelegt ist.
keyMaterial string Enthält den Netzwerkschlüssel oder die Passphrase.
Keytype Typ des Schlüssels.
MSM Enthält verschiedene MSM-Einstellungen. Dieses Element ist optional.
Namen nameType Name des WLAN-Profils.
Namen Enthält die SSID eines WLAN.
nonBroadcast boolean Gibt an, ob das Netzwerk seine SSID überträgt.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
OUI Enthält eine hexadezimalbinäre 3-Byte-Datei, die die IHV identifiziert.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
OUIHeader Identifiziert die IHV.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
phyType Gibt den wlan-Standard 802.11 an, der im WLAN verwendet wird. Der Wert "n" wird nur auf Windows Vista mit SP1 und neueren Versionen des Betriebssystems unterstützt.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
PMKCacheMode Gibt an, ob pmk caching verwendet wird. Dieses Element ist nur für WPA2-definierte Netzwerke gültig.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
PMKCacheSize Gibt die Anzahl der Einträge im PMK-Cache auf dem Client an. Dieses Element ist nur für WPA2-definierte Netzwerke gültig, bei denen PMKCacheMode auf "enabled" festgelegt ist. Wenn PMKCacheMode aktiviert ist und dieses Element nicht vorhanden ist, beträgt die Cachegröße standardmäßig 128 Einträge.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
PMKCacheTTL Gibt die Dauer in Minuten an, die ein PMK-Cache beibehalten wird. Dieses Element ist nur für WPA2-definierte Netzwerke gültig, bei denen PMKCacheMode auf "enabled" festgelegt ist.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
preAuthMode Bestimmt, ob die Vorauthentifizierung vom Client verwendet wird. Die Vorauthentifizierung ermöglicht wpa2 sicheres schnelles Roaming. Dieses Element ist nur für WPA2-definierte Netzwerke gültig, bei denen PMKCacheMode auf "enabled" festgelegt ist. Wenn PMKCacheMode aktiviert ist und dieses Element nicht vorhanden ist, ist der Standardwert deaktiviert.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
preAuthThrottle Gibt die Anzahl der Versuche an, die bei der Vorauthentifizierung bei benachbarten APs verwendet werden. Dieses Element ist nur für WPA2-definierte Netzwerke gültig, bei denen PMKCacheMode auf "enabled" festgelegt ist. Wenn PMKCacheMode aktiviert ist und dieses Element nicht vorhanden ist, wird die Anzahl der Versuche standardmäßig auf 3 festgelegt.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
protected boolean Gibt an, ob der Schlüssel verschlüsselt ist.
Windows XP mit SP3 und wlan-API für Windows XP mit SP2: Dieses Element muss den Wert FALSE haben.
Sicherheit Enthält verschiedene Sicherheitseinstellungen. Dieses Element ist optional.
Sicherheit Enthält IHV-spezifische Sicherheitseinstellungen. Microsoft-Sicherheitseinstellungen und IHV-Sicherheitseinstellungen schließen sich gegenseitig aus. Wenn beide Sicherheitseinstellungen im gleichen Profil vorhanden sind, ist das Profil ungültig.
Windows XP mit SP3 und der Wlan-LAN-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
sharedKey Enthält die Freigegebenen Schlüsselinformationen. Dieses Element ist nur erforderlich, wenn WEP- oder PSK-Schlüssel für das Authentifizierungs- und Verschlüsselungspaar erforderlich sind.
SSID Gibt die SSID eines WLAN an.
SSIDConfig Enthält mindestens ein SSIDs-System zusammen mit anderen allgemeinen Einstellungen.
Ein Profil kann mehrere SSIDConfig-Elemente enthalten, und jedes SSIDConfig-Element kann mehrere SSID-Elemente enthalten. Allerdings berücksichtigt Windows immer nur das erste SSIDConfig-Element in einem WLANProfile-Element.
Windows XP mit SP3 und der Wlan-LAN-API für Windows XP mit SP2: In einem Profil kann nur ein SSID-Element angezeigt werden.
type Enthält eine hexadezimalbinäre 1-Byte-Datei, die verwendet wird, um NICs durch dieselbe IHV zu unterscheiden.
Windows XP mit SP3 und der Wlan-LAN-API für Windows XP mit SP2: Dieses Element wird nicht unterstützt.
useMSOneX boolean Gibt den Ursprung von 802.1X-Sicherheitseinstellungen an, die von einer IHV-Sicherheitskomponente verwendet werden. Wenn useMSOneX true ist, verwenden IHV-Sicherheitskomponenten von Microsoft definierte 802.1X-Einstellungen. Wenn useMSOneX false ist, verwenden IHV-Sicherheitskomponenten vom Anbieter bereitgestellte 802.1X-Einstellungen. Standardmäßig ist useMSOneX false. Dieses Element ist optional.
useOneX boolean Gibt an, ob 802.1X verwendet wird. Dieses Flag ist optional.

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 im https://www.microsoft.com/networking/OneX/v1 -Namespace.

Das FIPSMode-Element kann als untergeordnetes Element des authEncryption-Elements eingefügt werden. Das OneX-Element kann als untergeordnetes Element des Sicherheitselements (MSM) eingefügt werden.

Informationen zum Anzeigen der Liste der untergeordneten Elemente in einer strukturbasierten Struktur finden Sie unter _ WLAN-Profilschemaelemente.

Beispiele

Beispielprofile finden Sie unter Beispiele für Drahtlosprofile.

Requirements (Anforderungen)

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

Weitere Informationen

Beispiele für Drahtlosprofile