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 |