Freigeben über


HotspotProfile-Schema

Das HotspotProfile-Schema definiert Elemente, die verwendet werden, um Anmeldeinformationen für Wi-Fi Hotspots zu beschreiben, die das WISPr-Protokoll (Wireless Internet Service Provider Roaming) verwenden. Alle Elemente befinden sich im Namespace http://www.microsoft.com/networking/WLAN/HotspotProfile/v1. Nicht alle Elemente befinden sich in jedem Profil, da einige Elemente optional sind.

Das vollständige HotspotProfile-Schema ist unten angegeben:

<?xml version="1.0" encoding="UTF-8"?>  
<xs:schema targetNamespace="http://www.microsoft.com/networking/WLAN/HotspotProfile/v1"  
    elementFormDefault="qualified"  
    xmlns="http://www.microsoft.com/networking/WLAN/HotspotProfile/v1"  
    xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  
  <xs:element name="BasicAuth">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="UserName" type="xs:token"/>  
        <xs:element name="Password" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="ExtAuth">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="ExtensionId" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="TrustedDomains">  
    <xs:annotation>  
      <xs:documentation xml:lang="en">  
        The element contains a set of host names that are trusted for providing credentials over HTTPS.  
        A domain name is either a fully qualified name such as hotspot.contoso.com  
        or a wildcard such as .contoso.com to refer to all hosts under the given domain name.  
      </xs:documentation>  
    </xs:annotation>  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="TrustedDomain" maxOccurs="unbounded" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="SSIDConfig">  
    <xs:annotation>  
      <xs:documentation xml:lang="en">  
        The element contains a set of additional SSID's that are handled by this profile  
        to reduce the number of SSID's in the WLAN profile store.  
        Windows will not auto-connect to these SSID's until a user manually connects  
        and sets the auto-connect flag for a specific SSID.  
      </xs:documentation>  
    </xs:annotation>  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="SSID" maxOccurs="250">  
          <xs:complexType>  
            <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="hexPrefix">  
                <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="1" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="namePrefix">  
                <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:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="HotspotProfile">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:choice>  
          <xs:sequence>  
            <xs:element ref="BasicAuth"/>  
            <xs:element ref="TrustedDomains"/>  
          </xs:sequence>  
          <xs:sequence>  
            <xs:element ref="ExtAuth"/>  
            <xs:element ref="TrustedDomains" minOccurs="0"/>  
          </xs:sequence>  
        </xs:choice>  
        <xs:element name="UserAgent" minOccurs="0" type="xs:token"/>  
        <xs:element ref="SSIDConfig" minOccurs="0"/>  
  
        <!-- extension point -->  
        <xs:any processContents="lax" namespace="##other" minOccurs="0" maxOccurs="unbounded"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
</xs:schema>

In der folgenden Tabelle sind alle Elemente in diesem Schema alphabetisch nach Namen sortiert.

Element BESCHREIBUNG
BasicAuth

Enthält den Benutzernamen und das Kennwort, die für die WISPr-Authentifizierung erforderlich sind. Die Verwendung von BasicAuth ermöglicht die Verwendung eines statischen Sets von Anmeldeinformationen. Verwenden Sie ExtAuth , damit eine App Anmeldeinformationen für die WISPr-Authentifizierung generiert.

ExtAuth

Enthält die Parameter für die Verarbeitung der WISPr-Authentifizierung über eine App (anstatt einen statischen Benutzernamen und ein Kennwort über BasicAuth anzugeben ).

ExtensionId

Der Paketfamilienname der App, die aufgerufen wird, um die WISPr-Authentifizierung zu verarbeiten.

HotspotProfile

Definiert die Eigenschaften und Anmeldeinformationen für einen Wi-Fi Hotspot. HotspotProfile ist das eindeutige Stammelement eines Wi-Fi Hotspotprofils, das das WISPr-Protokoll (Wireless Internet Service Provider Roaming) verwendet.

Kennwort

Kennwort, das für die WISPr-Authentifizierung verwendet werden soll.

SSID

Eine zusätzliche SSID, die von diesem Profil verarbeitet wird.

SSIDConfig

Enthält eine Reihe zusätzlicher SSIDs, die von diesem Profil verarbeitet werden, um die Anzahl von SSIDs im WLAN-Profilspeicher zu reduzieren. Windows SSIDs werden erst dann eine Verbindung hergestellt, wenn ein Benutzer eine manuelle Verbindung herstellt. Das neu erstellte Profil erbt die HotspotAuth-Einstellungen von diesem Profil.

TrustedDomain

Ein Hostname, der für die Bereitstellung von Anmeldeinformationen über HTTPS als vertrauenswürdig eingestuft wird. Kann entweder ein vollqualifizierter Name (z. B. hotspot.contoso.com) oder ein Platzhalter sein, um auf alle Hosts unter dem angegebenen Domänennamen (z. B. .contoso.com) zu verweisen.

TrustedDomains

Enthält einen Satz von Hostnamen, denen für die Bereitstellung von Anmeldeinformationen über HTTPS vertraut wird. Kann entweder ein vollqualifizierter Name (z. B. hotspot.contoso.com) oder ein Platzhalter sein, um auf alle Hosts unter dem angegebenen Domänennamen (z. B. .contoso.com) zu verweisen.

UserAgent

Angepasste HTTP-Benutzer-Agent-Zeichenfolge zur Unterstützung der operatorspezifischen Benutzer-Agent-Filterung. Dieses Element ist optional.

UserName

Benutzername, der für die WISPr-Authentifizierung verwendet werden soll.

hex

Definiert die SSID eines WLAN im Hexadezimalformat.

hexPrefix

Definiert eine Klasse von drahtlosen LANs, deren SSIDs mit den bereitgestellten Bytes beginnen.

name

Definiert die SSID eines WLAN im alphanumerischen Format.

namePrefix

Definiert eine Klasse von drahtlosen LANs, deren SSIDs mit den bereitgestellten Zeichen beginnen.