Élément WLANProfile

Article
06/26/2023

L’élément WLANProfile contient un profil LAN sans fil. Cet élément est l’élément racine unique d’un profil sans fil.

L’espace de noms cible pour l’élément WLANProfile est https://www.microsoft.com/networking/WLAN/profile/v1.

<xs:element name="WLANProfile">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="name"
                type="nameType"
             />
            <xs:element name="SSIDConfig"
                maxOccurs="256"
                ...
             />
            <xs:element name="Hotspot2"
                minOccurs="0"
                ...
             />
            <xs:element name="connectionType">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="IBSS">
                        <xs:enumeration value="ESS">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="connectionMode"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="auto">
                        <xs:enumeration value="manual">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="autoSwitch"
                minOccurs="0"
                type="boolean"
             />
            <xs:element name="MSM"
                minOccurs="0"
                ...
             />
            <xs:element name="IHV"
                minOccurs="0"
                ...
             />
            <xs:element name="MacRandomization"
                ...
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

Éléments parents

Aucun.

Éléments enfants

Élément	Type	Description
name	Nametype	Nom du profil WLAN.
SSIDConfig		Contient un ou plusieurs SSID pour les réseaux locaux sans fil.
Hotspot2		Étend le schéma de profil WLAN v1 pour prendre en charge les réseaux Hotspot 2.0.
connectionType		Indique si le réseau est une infrastructure (« ESS ») ou ad hoc (« IBSS »).
connectionMode		Indique si la connexion au réseau local sans fil doit être automatique (« auto ») ou initiée (« manuelle ») par l’utilisateur. Cet élément est facultatif.
Autoswitch	boolean	Détermine le comportement d’itinérance d’un réseau connecté automatiquement lorsqu’un réseau préféré est à portée. Cet élément est facultatif et n’a aucun effet sur un réseau connecté manuellement.
MSM		Contient différents paramètres de module spécifique au média (MSM).
IHV		Contient différents paramètres pour les fournisseurs de matériel indépendants.
MacRandomization		Configure la randomisation des adresses MAC.

name

Contient le nom d’un profil LAN sans fil.

Un nom respecte la casse.

Pour Windows XP avec Service Pack 3 (SP3) et l’API LAN sans fil pour Windows XP avec Service Pack 2 (SP2), l’élément name est ignoré lorsque le profil est enregistré dans le magasin de profils. Le nom du profil est dérivé du SSID du réseau. Pour les profils réseau d’infrastructure, le nom du profil est le SSID du réseau. Pour les profils réseau ad hoc, le nom du profil est le SSID du réseau ad hoc suivi de -adhoc. Les caractères d’échappement XML, tels que &, ne sont pas affichés. Évitez d’utiliser des caractères d’échappement XML dans les noms SSID pour les profils déployés sur Windows XP avec SP3 ou API LAN sans fil pour Windows XP avec SP2.

Pour tout profil réseau destiné à être utilisé uniquement sur Windows Vista ou Windows Server 2008, le nom peut être n’importe quelle chaîne.

connectionType

L’élément connectionType indique le mode de fonctionnement du réseau. La valeur ESS indique un réseau d’infrastructure, tandis qu’IBSS indique un réseau ad hoc.

connectionMode

L’élément connectionMode (WLANProfile) indique si la connexion à un réseau local sans fil doit être automatique ou initiée par l’utilisateur.

Si connectionType est défini sur ESS, cette valeur peut être automatique ou manuelle. La valeur par défaut est automatique si cet élément est absent.

Si connectionType est défini sur IBSS, cette valeur doit être manuelle.

<xs:element name="connectionMode">
    <xs:simpleType>
        <xs:restriction
            base="string"
        >
            <xs:enumeration
                value="auto"
             />
            <xs:enumeration
                value="manual"
             />
        </xs:restriction>
    </xs:simpleType>
</xs:element>

Le tableau suivant décrit les valeurs d’énumération.

Valeur	Description
auto	La connexion au réseau sans fil doit être lancée automatiquement chaque fois que le réseau est à portée.
manual	La connexion au réseau sans fil n’est établie qu’à la demande explicite d’un utilisateur.

Autoswitch

Détermine le comportement d’itinérance d’un réseau connecté automatiquement lorsqu’un réseau préféré est à portée. Cet élément est facultatif.

Si autoSwitch a la valeur « true » et connectionMode est défini sur « auto », une connexion à un réseau préféré doit être tentée chaque fois qu’un réseau préféré entre dans la plage. Un réseau plus préféré est un réseau qui est classé plus haut dans la liste des réseaux sans fil préférés. Cette tentative de connexion se produit quand vous êtes connecté à un autre réseau.

Si connectionMode a la valeur « auto », cette valeur peut être « true » ou « false ».

Si connectionMode a la valeur « manual », cette valeur doit être définie sur « false ». Cet élément n’a aucun effet sur un réseau connecté manuellement.

Une valeur autoSwitch définie sur « true » entraîne une fréquence plus élevée d’analyse périodique pour les nouveaux réseaux. Cela peut entraîner une augmentation de la pollution par fréquence radio par ces analyses périodiques et une augmentation de la consommation d’énergie utilisée par la carte réseau sans fil.

Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé : Les modifications sont implémentées sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé pour optimiser les performances de la mise en réseau sans fil. Ces modifications sont conçues pour réduire la pollution par fréquence radio, la consommation d’énergie et les perturbations du trafic en temps réel sur les réseaux sans fil. Le paramètre par défaut pour autoSwitch lorsque cet élément n’est pas défini dans un profil LAN sans fil a changé. Le paramètre par défaut est remplacé par « false » sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé. Le paramètre par défaut était « true » sur Windows Server 2008 et Windows Vista. Il est recommandé de définir la valeur « false » de l’élément autoSwitch utilisé par une application dans un profil LAN sans fil afin de réduire la fréquence d’analyse périodique des nouveaux réseaux, sauf s’il est absolument nécessaire qu’une application définisse cette valeur sur « true ».

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Cet élément n’est pas pris en charge.

Notes

La plupart des éléments enfants de l’élément WLANProfile se trouvent dans l’espace de https://www.microsoft.com/networking/WLAN/profile/v1 noms. Il existe deux exceptions : l’élément FIPSMode se trouve dans l’espace https://www.microsoft.com/networking/WLAN/profile/v2 de noms et l’élément OneX se trouve dans l’espace de https://www.microsoft.com/networking/OneX/v1 noms.

Pour afficher la liste des éléments enfants dans une structure de type arborescence, consultez WLAN_profile Éléments de schéma.

Exemples

Pour afficher les exemples de profils, consultez Exemples de profils sans fil.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Composant redistribuable	API LAN sans fil pour Windows XP avec SP2

Partager via