WLAN-Schema

  • Artikel

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>

SSIDPrefix

WLAN_v2-Schema