Elemen WLANProfile

Elemen WLANProfile berisi profil LAN nirkabel. Elemen ini adalah elemen akar unik untuk profil nirkabel.

Namespace layanan target untuk elemen WLANProfile adalah 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>

Elemen induk

Tidak ada.

Elemen anak

Elemen	Jenis	Deskripsi
nama	nameType	Nama profil WLAN.
SSIDConfig		Berisi satu atau beberapa SSID untuk LAN nirkabel.
Hotspot2		Memperluas Skema Profil WLAN v1 untuk mendukung jaringan Hotspot 2.0.
connectionType		Menunjukkan apakah jaringan adalah infrastruktur ("ESS") atau ad-hoc ("IBSS").
connectionMode		Menunjukkan apakah koneksi ke LAN nirkabel harus otomatis ("otomatis") atau dimulai ("manual") oleh pengguna. Elemen ini bersifat opsional.
autoSwitch	Boolean	Menentukan perilaku roaming jaringan yang terhubung secara otomatis ketika jaringan yang lebih disukai berada dalam rentang. Elemen ini bersifat opsional, dan tidak berpengaruh pada jaringan yang terhubung secara manual.
MSM		Berisi berbagai pengaturan modul khusus media (MSM).
IHV		Berisi berbagai pengaturan untuk vendor perangkat keras independen.
MacRandomization		Mengonfigurasi pengacakan alamat MAC.

nama

Berisi nama profil LAN nirkabel.

Nama peka huruf besar/kecil.

Untuk Windows XP dengan Service Pack 3 (SP3) dan Wireless LAN API untuk Windows XP dengan Service Pack 2 (SP2), elemen nama diabaikan saat profil disimpan di penyimpanan profil. Nama profil berasal dari SSID jaringan. Untuk profil jaringan infrastruktur, nama profil adalah SSID jaringan. Untuk profil jaringan ad hoc, nama profil adalah SSID jaringan ad hoc diikuti oleh -adhoc. Karakter escape XML, seperti &, tidak ditampilkan. Hindari menggunakan karakter escape XML dalam nama SSID untuk profil yang disebarkan pada Windows XP dengan SP3 atau Wireless LAN API untuk Windows XP dengan SP2.

Untuk profil jaringan apa pun yang dimaksudkan untuk digunakan hanya pada Windows Vista atau Windows Server 2008, nama dapat berupa string apa pun.

connectionType

Elemen connectionType menunjukkan mode operasi jaringan. Nilai ESS menunjukkan jaringan infrastruktur, sementara IBSS menunjukkan jaringan ad-hoc.

connectionMode

Elemen connectionMode (WLANProfile) menunjukkan apakah koneksi ke LAN nirkabel harus otomatis atau dimulai oleh pengguna.

Jika connectionType diatur ke ESS, nilai ini dapat berupa otomatis atau manual. Nilai default adalah otomatis jika elemen ini tidak ada.

Jika connectionType diatur ke IBSS, nilai ini harus manual.

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

Tabel berikut ini menjelaskan nilai enumerasi.

Nilai	Deskripsi
auto	Koneksi ke jaringan nirkabel harus dimulai secara otomatis setiap kali jaringan dalam jangkauan.
manual	Koneksi ke jaringan nirkabel hanya dimulai atas permintaan eksplisit pengguna.

autoSwitch

Menentukan perilaku roaming jaringan yang terhubung secara otomatis ketika jaringan yang lebih disukai berada dalam rentang. Elemen ini bersifat opsional.

Jika autoSwitch adalah "true" dan connectionMode diatur ke "auto", koneksi ke jaringan yang lebih disukai harus dicoba setiap kali jaringan yang lebih disukai berada dalam rentang. Jaringan yang lebih disukai adalah jaringan yang diurutkan lebih tinggi dalam daftar jaringan nirkabel pilihan. Upaya koneksi ini terjadi ketika tersambung ke jaringan lain.

Jika connectionMode diatur ke "auto", nilai ini dapat berupa "true" atau "false".

Jika connectionMode diatur ke "manual", nilai ini harus diatur ke "false". Elemen ini tidak berpengaruh pada jaringan yang terhubung secara manual.

Nilai autoSwitch yang diatur ke "true" menghasilkan frekuensi pemindaian berkala yang lebih tinggi untuk jaringan baru. Hal ini dapat mengakibatkan peningkatan polusi frekuensi radio dari pemindaian berkala ini dan peningkatan konsumsi daya yang digunakan oleh adaptor jaringan nirkabel.

Windows 7 dan Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal: Perubahan diterapkan pada Windows 7 dan Windows Server 2008 R2 dengan Layanan LAN Nirkabel diinstal untuk mengoptimalkan performa jaringan nirkabel. Perubahan ini dirancang untuk mengurangi polusi frekuensi radio, konsumsi daya, dan gangguan pada lalu lintas real time melalui jaringan nirkabel. Pengaturan default untuk autoSwitch ketika elemen ini tidak diatur dalam profil LAN nirkabel telah berubah. Pengaturan default diubah menjadi "false" pada Windows 7 dan Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal. Pengaturan defaultnya adalah "true" pada Windows Server 2008 dan Windows Vista. Disarankan agar nilai elemen autoSwitch yang digunakan oleh aplikasi di profil LAN nirkabel diatur ke "false" untuk mengurangi frekuensi pemindaian berkala untuk jaringan baru, kecuali jika benar-benar diperlukan aplikasi untuk mengatur nilai ini ke "true".

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Elemen ini tidak didukung.

Keterangan

Sebagian besar elemen anak dari elemen WLANProfile berada di https://www.microsoft.com/networking/WLAN/profile/v1 namespace layanan. Ada dua pengecualian: elemen FIPSMode ada di https://www.microsoft.com/networking/WLAN/profile/v2 namespace layanan, dan elemen OneX ada di https://www.microsoft.com/networking/OneX/v1 namespace layanan.

Untuk melihat daftar elemen anak dalam struktur seperti pohon, lihat WLAN_profile Elemen Skema.

Contoh

Untuk melihat profil sampel, lihat Sampel profil nirkabel.

Persyaratan

Persyaratan	Value
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Redistribusi	API LAN nirkabel untuk Windows XP dengan SP2