OneX 元素

OneX 元素指定有线或无线 LAN 配置文件的 802.1X 配置信息。 此元素是 802.1X 配置文件的唯一根元素。

OneX 元素的目标命名空间为 https://www.microsoft.com/networking/OneX/v1。 OneX 元素的大多数子元素都位于 命名空间中 OneX 。 有一个例外: EAPConfig 元素位于 命名空间中 https://www.microsoft.com/provisioning/EapHostConfig

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 仅支持 EAPConfig 元素。 其他元素(如果存在于配置文件中)将被忽略。

<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>

父元素

无。

子元素

元素 类型 说明
cacheUserData boolean 指定是否为后续连接缓存用户凭据。
heldPeriod 指定客户端在身份验证尝试失败后不会重新尝试身份验证的时间长度(以秒为单位)。
authPeriod 指定客户端等待验证器响应的最大时间长度(以秒为单位)。
startPeriod 指定发送EAPOL-Start之前等待的时间长度(以秒为单位)。
maxStart 指定发送的最大EAPOL-Start消息数。
maxAuthFailures 指定一组凭据允许的最大身份验证失败次数。
supplicantMode 指定用于 EAPOL-Start 消息的传输方法。
authMode 指定用于身份验证的凭据的类型。
singleSignOn 指定单一登录 (SSO) 网络配置信息。
EAPConfig 指定 EAPHost 配置。

cacheUserData

cacheUserData (OneX) 元素指定是否为后续连接缓存用户凭据。 当 cacheUserData 为 TRUE 时,将缓存凭据。 如果 cacheUserData 为 FALSE,则不会缓存凭据,并且可能会在后续连接尝试时提示用户输入凭据。

此元素为可选元素。 如果未在配置文件中指定 cacheUserData,则会缓存用户凭据。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

heldPeriod

heldPeriod (OneX) 元素指定客户端在身份验证尝试失败后不会重新尝试身份验证的时间长度(以秒为单位)。

此元素为可选元素。 如果未在配置文件中指定 heldPeriod,则使用值 1 秒。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

authPeriod

authPeriod (OneX) 元素指定客户端等待验证器响应的最大时间长度(以秒为单位)。 如果在指定时间段内未收到响应,则客户端假定网络上不存在验证器。

此元素为可选元素。 如果未在配置文件中指定 authPeriod,则使用值 18 秒。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

startPeriod

startPeriod (OneX) 元素指定发送EAPOL-Start之前等待的时间长度(以秒为单位)。 发送EAPOL-Start消息以启动 802.1X 身份验证过程。

此元素为可选元素。 如果未在配置文件中指定 startPeriod,则使用值 5 秒。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

maxStart

maxStart (OneX) 元素指定发送的最大EAPOL-Start消息数。 发送的最大EAPOL-Start消息数后,客户端假定网络上不存在验证器。

此元素为可选元素。 如果未在配置文件中指定 maxStart,则使用值 3 条消息。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

maxAuthFailures

maxAuthFailures (OneX) 元素指定一组凭据允许的最大身份验证失败次数。

此元素为可选元素。 如果未在配置文件中指定 maxAuthFailures,则使用值 1。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

supplicantMode

supplicantMode (OneX) 元素指定用于EAPOL-Start消息的传输方法。 下表说明可用的值。

说明
inhibitTransmission 不会传输EAPOL-Start消息。 仅适用于有线 LAN 配置文件。
includeLearning 客户端根据网络功能确定何时发送EAPOL-Start数据包。 仅在需要时发送EAPOL-Start消息。 仅适用于有线 LAN 配置文件。
符合 EAPOL-Start消息由 802.1X 指定传输。 对有线和无线 LAN 配置文件均有效。

此元素为可选元素。 如果未在配置文件中指定 supplicantMode,则有线和无线 LAN 配置文件都使用 值 compliant

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

authMode

authMode (OneX) 元素指定用于身份验证的凭据的类型。 下表说明可用的值。

说明
machineOrUser 使用计算机或用户凭据。 当用户登录时,用户的凭据将用于身份验证。 如果没有用户登录,则使用计算机凭据。
计算机 仅使用计算机凭据。
user 仅使用用户凭据。
guest 仅使用来宾 (空) 凭据。

此元素为可选元素。 如果未在配置文件中指定 authMode,则使用 的值 machineOrUser

具有 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 的无线 LAN API: 如果此元素存在于配置文件中,则将忽略它。

可以使用 netsh wlan set profileparameter 命令在命令行上设置此参数。 有关详细信息,请参阅 适用于无线局域网的 Netsh 命令 (wlan)

EAPConfig

EAPConfig (OneX) 元素指定 EAPHost 配置。

与 802.1X 配置文件架构中的大多数元素不同,此元素位于 命名空间中 https://www.microsoft.com/provisioning/EapHostConfig 。 其子元素在 eaphostconfig 架构中定义。 EapHostConfig 元素是 EAPConfig 元素的子元素。

备注

若要查看树状结构中子元素的列表,请参阅 OneX 架构元素

要求

要求
最低受支持的客户端 Windows Vista、Windows XP 和 SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
可再发行组件 适用于 Windows XP 的无线 LAN API SP2