WLAN-Schema
Das WLAN-Schema definiert Elemente, die verwendet werden, um die Verbindung eines Abonnenten mit einem WLAN (Wireless Local Area Network) zu beschreiben.
Alle Elemente im WLAN-Schema befinden sich im *http://www.microsoft.com/networking/CarrierControl/WLAN/v1* -Namespace.
Das WLAN_v2 Schema definiert zusätzliche Elemente im http://www.microsoft.com/networking/CarrierControl/WLAN/v2 Namespace und wird auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Das SSIDConfig-Element im WLAN-Schema unterstützt bis zu 25 SSIDs im v1-Namespace und bis zu 10.000 zusätzliche SSIDs im v2-Namespace. Der v2-Namespace unterstützt auch SSIDPrefix-Elemente .
Nicht alle Elemente befinden sich in jedem Profil, da einige Elemente optional sind.
In der folgenden Tabelle sind alle Elemente in diesem Schema alphabetisch nach Namen sortiert.
| Element | BESCHREIBUNG |
|---|---|
| AssociatedPlan | Enthält den Namen des Datenplans des Abonnenten. Sie muss mit dem Name-Attribut eines Plans im gleichen XML-Dokument übereinstimmen. |
| MSM | Definiert verschiedene MSM-Einstellungen (Media-Specific Module) für dieses Profil in einem WLAN. |
| PMKCacheMode | Definiert, ob das Zwischenspeichern des pmK (Pairwise Master Key) von diesem Profil verwendet werden soll, um eine Verbindung mit einem WLAN herzustellen. |
| PMKCacheSize | Definiert die Anzahl der Einträge im PMK-Cache (Pairwise Master Key) auf dem Client. Muss ein Wert zwischen 1 und einschließlich 255 sein. |
| PMKCacheTTL | Definiert die Zeitspanne in Minuten, die ein PMK-Cache (Pairwise Master Key) beibehalten wird. Muss ein Wert zwischen 5 und einschließlich 1440 sein. |
| SSID | Enthält die SSID für ein WLAN. |
| SSIDConfig | Definiert einen oder mehrere Dienstsatzbezeichner (Service Set Identifiers, SSID) für ein Wlan. |
| WLANProfile | Definiert die Eigenschaften und Sicherheitseinstellungen des WLAN-Verbindungsprofils eines Abonnenten. WLANProfile ist das eindeutige Stammelement eines Funkprofils. |
| authEncryption | Definiert das Authentifizierungs- und Verschlüsselungspaar, das für dieses Profil in einem WLAN verwendet werden soll. |
| Authentifizierung | Definiert die Authentifizierungsmethode, die von diesem Profil verwendet werden soll, um eine Verbindung mit einem WLAN herzustellen. |
| Verschlüsselung | Definiert den Typ der Datenverschlüsselung, die von diesem Profil für die Verbindung mit einem WLAN verwendet werden soll. |
| hex | Definiert die SSID eines Drahtlos-LAN im Hexadezimalformat. |
| keyIndex | Definiert, welcher Schlüsselindex zum Verschlüsseln von Drahtlosdatenverkehr verwendet werden soll. keyIndex wird nur verwendet, wenn keyTypenetworkKey ist. Der Standardwert ist 0, wenn sharedKey vorhanden ist. Muss ein Wert zwischen 0 und 3 (einschließlich) sein. |
| keyMaterial | Definiert einen Netzwerkschlüssel oder einen Passphrase. Wenn protectedtrue ist, wird das Schlüsselmaterial verschlüsselt. Andernfalls ist das Schlüsselmaterial unverschlüsselt. Verschlüsseltes Schlüsselmaterial wird in hexadezimaler Form ausgedrückt. |
| Keytype | Definiert, ob der freigegebene Schlüssel ein Netzwerkschlüssel oder ein Passphrase ist. |
| name (in SSID) | Definiert die SSID eines Drahtlos-LAN im alphanumerischen Format. |
| name (Typ: NameType) | Definiert den Namen eines WLAN-Profils, bei dem die Groß-/Kleinschreibung beachtet wird. |
| preAuthMode | Definiert, ob die Vorauthentifizierung vom Client verwendet wird. |
| preAuthThrottle | Definiert die Anzahl der Vorauthentifizierungsversuche auf benachbarten Zugriffspunkten (AP). Muss ein Wert zwischen 1 und einschließlich 16 sein. |
| protected | True gibt an, dass der gemeinsam verwendete Schlüssel verschlüsselt ist. Andernfalls lautet der Wert false. |
| security | Definiert verschiedene Sicherheitseinstellungen für dieses Profil in einem WLAN. |
| sharedKey | Definiert optionale Informationen zu gemeinsam verwendeten Schlüsseln, die von diesem Profil zum Herstellen einer WLAN-Verbindung verwendet werden sollen. |
| useOneX | True gibt an, dass die 802.1X-Authentifizierung von diesem Profil verwendet werden soll, um eine Verbindung mit dem WLAN herzustellen. Andernfalls lautet der Wert false. |
Das vollständige WLAN-Schema ist unten angegeben:
<?xml version="1.0" encoding="utf-8"?>
<xs:schema targetNamespace="http://www.microsoft.com/networking/CarrierControl/WLAN/v1"
elementFormDefault="qualified"
xmlns="http://www.microsoft.com/networking/CarrierControl/WLAN/v1"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:base="http://www.microsoft.com/networking/CarrierControl/Base/v1">
<xs:import namespace="http://www.microsoft.com/networking/CarrierControl/Base/v1" />
<!-- WISPR Credentials in separate schema; uses xs:any tag below -->
<xs:element name="WLANProfile" type="CarrierWLANProfile"/>
<xs:complexType name="CarrierWLANProfile">
<xs:sequence>
<!-- Profile name is required. -->
<xs:element name="name" type="base:NameType" />
<xs:element name="Associated Plan" type="xs:string" minOccurs="0"/>
<!-- SSIDs are required. -->
<xs:element name="SSIDConfig" maxOccurs="1">
<xs:complexType>
<xs:sequence>
<xs:annotation>
<xs:documentation>
This element supports up to 25 SSIDs in the v1 namespace and up to additional 10000 SSIDs in the v2 namespace.
The v2 namespace also supports SSID prefixes.
</xs:documentation>
</xs:annotation>
<xs:element name="SSID" maxOccurs="25">
<xs:complexType>
<!-- Either Hex or named SSID must be present. -->
<xs:choice>
<xs:element name="hex">
<xs:simpleType>
<xs:restriction base="xs:hexBinary">
<xs:minLength value="1" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
<!-- SSID and SSIDPrefix elements from v2 namespace can be set here.
<xs:element name="SSID" minOccurrence="0" maxOccurrence="10000"
namespace="http://www.microsoft.com/networking/WLAN/profile/v2"/>
<xs:element name="SSIDPrefix" minOccurrence="0" maxOccurrence="32"
namespace="http://www.microsoft.com/networking/WLAN/profile/v2"/>
-->
<!-- extension point for other namespaces -->
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- wireless LAN MSM settings -->
<xs:element name="MSM" minOccurs="0">
<xs:complexType>
<xs:sequence>
<!-- security settings -->
<xs:element name="security" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="authEncryption">
<xs:complexType>
<xs:sequence>
<!-- valid authentication methods -->
<xs:element name="authentication">
<xs:simpleType>
<xs:restriction base="xs: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>
<!-- valid encryption methods -->
<xs:element name="encryption">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="none" />
<xs:enumeration value="WEP" />
<xs:enumeration value="TKIP" />
<xs:enumeration value="AES" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- flag indicating use of 802.1X -->
<xs:element name="useOneX" type="xs:boolean" minOccurs="0" />
<!-- extension point for other namespaces; allowed for OneX, etc. -->
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- Optional MSM security settings. -->
<!-- there is no default value for sharedKey if absent -->
<xs:element name="sharedKey" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="keyType">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="networkKey" />
<xs:enumeration value="passPhrase" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="protected" type="xs:boolean" />
<xs:element name="keyMaterial" type="xs:string" />
<!-- extension point for other namespaces -->
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- the default value is 0 when the shared key is present -->
<xs:element name="keyIndex" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0" />
<xs:maxInclusive value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- For WPA2, the default value is "enabled"
for all others, the default value is "disabled"
-->
<xs:element name="PMKCacheMode" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="disabled" />
<xs:enumeration value="enabled" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- the default value is 720 minutes -->
<xs:element name="PMKCacheTTL" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="5" />
<xs:maxInclusive value="1440" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- the default value is 128 entries -->
<xs:element name="PMKCacheSize" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1" />
<xs:maxInclusive value="255" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- the default value is "disabled" -->
<xs:element name="preAuthMode" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="disabled" />
<xs:enumeration value="enabled" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- the default value is 3 times -->
<xs:element name="preAuthThrottle" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1" />
<xs:maxInclusive value="16" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<!-- extension point for other namespaces -->
<!-- this is the insertion point for OneX and HotspotAuth namespaces -->
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- extension point for other namespaces -->
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Priority" type="base:Priority" default="5"/>
</xs:complexType>
<xs:element name="WLANProfile" type="CarrierWLANProfile"/>
</xs:schema>
<!-- provisioning_wlan_v2 -->
<!-- The following shows the new elements in version 2 that can be included -->
<?xml version="1.0" encoding="utf-8"?>
<xs:schema targetNamespace="http://www.microsoft.com/networking/CarrierControl/WLAN/v2"
elementFormDefault="qualified"
xmlns="http://www.microsoft.com/networking/CarrierControl/WLAN/v2"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
>
<xs:element name="SSID">
<xs:complexType>
<!-- Either Hex or named SSID must be present. -->
<xs:choice>
<xs:element name="hex">
<xs:simpleType>
<xs:restriction base="xs:hexBinary">
<xs:minLength value="1" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
<xs:element name="SSIDPrefix">
<xs:complexType>
<!-- Either Hex or named SSID must be present. -->
<xs:choice>
<xs:element name="hex">
<xs:simpleType>
<xs:restriction base="xs:hexBinary">
<xs:minLength value="4" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="4" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
Zugehörige Themen