OneX-Element
Das OneX-Element gibt 802.1X-Konfigurationsinformationen für ein kabelgebundenes oder WLAN-Profil an. Dieses Element ist das eindeutige Stammelement für ein 802.1X-Profil.
Der Zielnamespace für das OneX-Element ist https://www.microsoft.com/networking/OneX/v1
. Die meisten untergeordneten Elemente des OneX-Elements befinden sich im OneX
Namespace. Es gibt eine Ausnahme: Das EAPConfig-Element befindet sich im https://www.microsoft.com/provisioning/EapHostConfig
Namespace.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Nur das EAPConfig-Element wird unterstützt. Andere Elemente, wenn sie in einem Profil vorhanden sind, werden ignoriert.
<xs:element name="OneX">
<xs:complexType>
<xs:sequence>
<xs:element name="cacheUserData"
minOccurs="0"
type="boolean"
/>
<xs:element name="heldPeriod"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1">
<xs:maxInclusive value="3600">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="authPeriod"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1">
<xs:maxInclusive value="3600">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="startPeriod"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1">
<xs:maxInclusive value="3600">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="maxStart"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1">
<xs:maxInclusive value="100">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="maxAuthFailures"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1">
<xs:maxInclusive value="100">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="supplicantMode"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="inhibitTransmission">
<xs:enumeration value="includeLearning">
<xs:enumeration value="compliant">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="authMode"
minOccurs="0"
>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="machineOrUser">
<xs:enumeration value="machine">
<xs:enumeration value="user">
<xs:enumeration value="guest">
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="singleSignOn"
minOccurs="0"
...
/>
<xs:element name="EAPConfig"/>
<xs:any
processContents="lax"
minOccurs="0"
maxOccurs="unbounded"
namespace="##other"
/>
</xs:sequence>
</xs:complexType>
</xs:element>
Übergeordnete Elemente
Keine.
Untergeordnete Elemente
Element | type | BESCHREIBUNG |
---|---|---|
cacheUserData | boolean | Gibt an, ob die Benutzeranmeldeinformationen für nachfolgende Verbindungen zwischengespeichert werden. |
heldPeriod | Gibt die Zeitspanne in Sekunden an, in der ein Client die Authentifizierung nach einem fehlgeschlagenen Authentifizierungsversuch nicht erneut versucht. | |
authPeriod | Gibt die maximale Zeitdauer in Sekunden an, in der ein Client auf eine Antwort vom Authentifikator wartet. | |
startPeriod | Gibt die Zeitdauer in Sekunden an, die gewartet werden soll, bevor ein EAPOL-Start gesendet wird. | |
maxStart | Gibt die maximale Anzahl von EAPOL-Start gesendeten Nachrichten an. | |
maxAuthFailures | Gibt die maximale Anzahl von Authentifizierungsfehlern an, die für einen Satz von Anmeldeinformationen zulässig sind. | |
supplicantMode | Gibt die Übertragungsmethode an, die für EAPOL-Startmeldungen verwendet wird. | |
authMode | Gibt den Typ der Anmeldeinformationen an, die für die Authentifizierung verwendet werden. | |
singleSignOn | Gibt Netzwerkkonfigurationsinformationen für einmaliges Anmelden (Single Sign-On, SSO) an. | |
EAPConfig | gibt die EAPHost-Konfiguration an. |
cacheUserData
Das cacheUserData (OneX)-Element gibt an, ob die Benutzeranmeldeinformationen für nachfolgende Verbindungen zwischengespeichert werden. Wenn cacheUserData auf TRUE festgelegt ist, werden die Anmeldeinformationen zwischengespeichert. Wenn cacheUserData auf FALSE festgelegt ist, werden die Anmeldeinformationen nicht zwischengespeichert, und der Benutzer wird bei nachfolgenden Verbindungsversuchen möglicherweise zur Eingabe von Anmeldeinformationen aufgefordert.
Dieses Element ist optional. Wenn cacheUserData in einem Profil nicht angegeben ist, werden die Benutzeranmeldeinformationen zwischengespeichert.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
heldPeriod
Das heldPeriod -Element (OneX) gibt die Zeitspanne in Sekunden an, in der ein Client die Authentifizierung nach einem fehlgeschlagenen Authentifizierungsversuch nicht erneut versucht.
Dieses Element ist optional. Wenn heldPeriod in einem Profil nicht angegeben ist, wird der Wert 1 Sekunde verwendet.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
authPeriod
Das authPeriod (OneX)-Element gibt die maximale Zeitdauer in Sekunden an, in der ein Client auf eine Antwort vom Authentifikator wartet. Wenn innerhalb des angegebenen Zeitraums keine Antwort empfangen wird, geht der Client davon aus, dass im Netzwerk kein Authentifikator vorhanden ist.
Dieses Element ist optional. Wenn authPeriod in einem Profil nicht angegeben ist, wird ein Wert von 18 Sekunden verwendet.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
startPeriod
Das startPeriod -Element (OneX) gibt die Zeitspanne in Sekunden an, die gewartet werden soll, bevor ein EAPOL-Start gesendet wird. Eine EAPOL-Start Nachricht wird gesendet, um den 802.1X-Authentifizierungsprozess zu starten.
Dieses Element ist optional. Wenn startPeriod in einem Profil nicht angegeben ist, wird ein Wert von 5 Sekunden verwendet.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
maxStart
Das maxStart -Element (OneX) gibt die maximale Anzahl der gesendeten EAPOL-Start Nachrichten an. Nachdem die maximale Anzahl von EAPOL-Start Nachrichten gesendet wurde, geht der Client davon aus, dass im Netzwerk kein Authentifikator vorhanden ist.
Dieses Element ist optional. Wenn maxStart in einem Profil nicht angegeben ist, wird der Wert 3 Nachrichten verwendet.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
maxAuthFailures
Das maxAuthFailures -Element (OneX) gibt die maximale Anzahl von Authentifizierungsfehlern an, die für einen Satz von Anmeldeinformationen zulässig sind.
Dieses Element ist optional. Wenn maxAuthFailures in einem Profil nicht angegeben ist, wird der Wert 1 verwendet.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
supplicantMode
Das SupplicantMode -Element (OneX) gibt die Methode der Übertragung an, die für EAPOL-Start Nachrichten verwendet wird. In der folgenden Tabelle sind die möglichen Werte beschrieben.
Wert | BESCHREIBUNG |
---|---|
inhibitTransmission | EAPOL-Start Nachrichten werden nicht übertragen. Gilt nur für kabelgebundene LAN-Profile. |
includeLearning | Der Client bestimmt basierend auf der Netzwerkfunktion, wann EAPOL-Start Pakete gesendet werden sollen. EAPOL-Start Nachrichten werden nur bei Bedarf gesendet. Gilt nur für kabelgebundene LAN-Profile. |
Kompatibel | EAPOL-Start Nachrichten werden gemäß 802.1X übertragen. Gültig für kabelgebundene und WLAN-Profile. |
Dieses Element ist optional. Wenn supplicantMode in einem Profil nicht angegeben ist, wird sowohl für kabelgebundene als auch für WLAN-Profile der Wert compliant
verwendet.
Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
authMode
Das authMode -Element (OneX) gibt den Typ der Anmeldeinformationen an, die für die Authentifizierung verwendet werden. In der folgenden Tabelle sind die möglichen Werte beschrieben.
Wert | BESCHREIBUNG |
---|---|
machineOrUser | Verwenden Sie Computer- oder Benutzeranmeldeinformationen. Wenn ein Benutzer angemeldet ist, werden die Anmeldeinformationen des Benutzers für die Authentifizierung verwendet. Wenn kein Benutzer angemeldet ist, werden Computeranmeldeinformationen verwendet. |
Computer | Verwenden Sie nur Computeranmeldeinformationen. |
user | Verwenden Sie nur Benutzeranmeldeinformationen. |
guest | Verwenden Sie nur Gastanmeldeinformationen (leer). |
Dieses Element ist optional. Wenn authMode in einem Profil nicht angegeben wird, wird der Wert von machineOrUser
verwendet.
Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Dieses Element wird ignoriert, wenn es in einem Profil vorhanden ist.
Dieser Parameter kann über die Befehlszeile mit dem Befehl netsh wlan set profileparameter festgelegt werden. Weitere Informationen finden Sie unter Netsh Commands for Wireless Local Area Network (WLAN).
EAPConfig
Das EAPConfig (OneX)-Element gibt die EAPHost-Konfiguration an.
Im Gegensatz zu den meisten Elementen im 802.1X-Profilschema befindet sich dieses Element im https://www.microsoft.com/provisioning/EapHostConfig
Namespace. Die untergeordneten Elemente sind im eaphostconfig-Schema definiert. Das EapHostConfig-Element ist ein untergeordnetes Element des EAPConfig-Elements .
Bemerkungen
Informationen zum Anzeigen der Liste der untergeordneten Elemente in einer strukturähnlichen Struktur finden Sie unter OneX-Schemaelemente.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP3 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Verteilbare Komponente | Wlan-API für Windows XP mit SP2 |