WiFi CSP

2025-06-10

WiFi 設定服務提供者提供在 Windows 裝置上新增或刪除 Wi-Fi 網路的功能。設定服務提供者會接受 SyncML 輸入，並將它轉換成安裝在裝置上的網路配置檔。此配置檔可讓裝置在範圍內連線到 Wi-Fi 網路。

程式設計考慮：

如果驗證方法需要憑證 (例如 EAP-TLS) 的用戶端憑證，您必須透過 CertificateStore 設定服務提供者進行設定。 WiFi 設定服務提供者不提供該功能;相反地，Wi-Fi 配置檔可以指定要用來為該網路選擇正確憑證的憑證特性。在部署 Wi-Fi 網路設定之前，伺服器必須先成功註冊憑證。例如，針對EAP-TLS 配置檔，伺服器必須先成功設定並註冊必要的客戶端憑證，才能部署 Wi-Fi 配置檔。自我簽署憑證適用於 EAP-TLS/PEAP-MSCHAPv2，但 EAP-TLS 不支援此憑證。
針對 WEP、WPA 和 WPA2 型網路，請在純文字的網路設定中包含通行密鑰。傳遞金鑰儲存在裝置上時會自動加密。
SSID LocURI 節點的元件必須是以 RFC 2396 為基礎的有效 URI。此條件需要所有未排除的 ASCII 字元都必須使用 %-character 逸出，包括將空格符 (') 取代為 '%20'。不支援包含 Unicode) 但不需逸出的字元 (。
針對WiFi CSP，除非節點已經存在，否則您無法使用 Replace 命令。
在 Windows 用戶端版本中使用 Proxy、 ProxyPacUrl 或 ProxyWPAD (家用版、專業版、企業版和教育版) 可能會失敗或沒有作用。請改用 NetworkProxy CSP。

下列清單顯示 WiFi 設定服務提供者節點：

./Device/Vendor/MSFT/WiFi
- 輪廓
  - {SSID}
    - ProfileSource
    - Proxy
    - ProxyPacUrl
    - ProxyWPAD
    - WiFiCost
    - WlanXml
./User/Vendor/MSFT/WiFi
- 輪廓
  - {SSID}
    - ProfileSource
    - Proxy
    - ProxyPacUrl
    - ProxyWPAD
    - WiFiCost
    - WlanXml

裝置/配置檔

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1511 [10.0.10586] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile

識別 Wi-Fi 網路設定。每個 Wi-Fi 網路組態都是以配置檔物件表示。此網路配置檔包含裝置連線到該網路所需的所有資訊，例如 SSID、驗證和加密方法，以及 WEP 或 WPA2 網路的複雜密碼。

描述架構屬性:

屬性名稱	屬性值
格式	`node`
存取類型	[取得]

Device/Profile/{SSID}

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1511 [10.0.10586] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}

Wi-Fi 網路的配置檔名稱。當 WlanXml 節點在刪除時加入和刪除時，就會新增此專案。

指定 Wi-Fi 網路的配置檔名稱， (建立、設定、查詢或刪除) 最多 32 個字節。名稱會區分大小寫，而且可以用 ASCII 表示。在 URI 中，它必須是 %-escaped，但非%逸出的值會在系統內使用。

注意

此欄位是使用者顯示為「易記名稱」的設定檔名稱，並包含 Wi-Fi 設定資訊。非%逸出的值必須在中對應至 <name><WLANProfile> <name>。

配置檔名稱可以與) 下 <WLANProfile> <SSIDConfig> <SSID> <name> 實際廣播網路的 SSID 相同或不同 (。例如，廣播 SSID 可能是「CC_Corp_7」，但配置檔名稱可能是「ContosoWiFi」。。

描述架構屬性:

屬性名稱	屬性值
格式	`node`
存取類型	新增、刪除、取得、取代
動態節點命名	ServerGeneratedUniqueIdentifier

在下列範例中，會新增『ContosoWiFi』配置檔，並以『CC_Corp_7』 SSID 為目標。為了簡潔起見，會省略配置檔的其餘部分 - 如需完整範例，請參閱新增網路。

<Atomic>
  <CmdID>300</CmdID>
  <Add>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/ContosoWiFi/WlanXml</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>ContosoWiFi</name><SSIDConfig><SSID><name>CC_Corp_7</name></SSID></SSIDConfig>{...}</WLANProfile>]]></Data>
    </Item>
  </Add>
</Atomic>

重要

如果 MDM SyncML 中未正確設定設定檔名稱，則根據 Wi-Fi 設定 XML () <WLANProfile> 中的資訊，可能會在運行時間導致一些非預期的錯誤。換句話說，如果設定檔是 <WLANProfile><name>Contoso Wi-Fi</name>{...}，則 MDM SyncML 必須是 <LocURI>./Vendor/MSFT/WiFi/Profile/Contoso%20Wi-Fi/WlanXml</LocURI>。

在此範例中，如果我們改為使用 <LocURI>./Vendor/MSFT/WiFi/Profile/CC_Corp_7/WlanXml</LocURI>，配置檔會被視為已布建使用者，而不是布建 MDM，這可能會導致使用者連線到錯誤的網路。

Device/Profile/{SSID}/ProfileSource

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 11 版本 22H2 [10.0.22621] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/ProfileSource

允許定義哪個系統管理實體設定此 Wi-Fi 配置檔。這目前可以設定為 0=Enterprise 或 1=Mobile Operator。

描述架構屬性:

屬性名稱	屬性值
格式	`int`
存取類型	取得、取代
預設值	0

允許的值:

值	描述
0 (預設值)	企業。
1	電信業者。

Device/Profile/{SSID}/Proxy

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1511 [10.0.10586] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/Proxy

選擇性節點。格式為url：port。如果有任何) ，則會 (網路 Proxy 的設定。

注意

請勿使用。在 Windows 用戶端版本中使用此設定可能會失敗或沒有作用。請改用 NetworkProxy CSP。

描述架構屬性:

屬性名稱	屬性值
格式	`chr` (字串)
存取類型	新增、刪除、取得、取代

Device/Profile/{SSID}/ProxyPacUrl

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10，版本 1607 [10.0.14393] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyPacUrl

選擇性節點。 PAC 檔案位置的 URL。

注意

請勿使用。在 Windows 用戶端版本中使用此設定可能會失敗或沒有作用。請改用 NetworkProxy CSP。

描述架構屬性:

屬性名稱	屬性值
格式	`chr` (字串)
存取類型	新增、刪除、取得、取代

Device/Profile/{SSID}/ProxyWPAD

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10，版本 1607 [10.0.14393] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyWPAD

選擇性節點。欄位的存在可讓 WPAD 進行 Proxy 查閱。

注意

請勿使用。在 Windows 用戶端版本中使用此設定可能會失敗或沒有作用。請改用 NetworkProxy CSP。

描述架構屬性:

屬性名稱	屬性值
格式	`bool`
存取類型	新增、刪除、取得、取代

允許的值:

值	描述
false	停用 WPAD 以進行 Proxy 查閱。
true	啟用 WPAD 以進行 Proxy 查閱。

Device/Profile/{SSID}/WiFiCost

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1809 [10.0.17763] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/WiFiCost

選擇性節點。如果原則作用中，請從下列清單中選取其中一個值，將會設定 Wi-Fi 配置檔的WLAN 連線成本。 (1：Unrestricted - 無限制連線，2：已修正 - 容量限制上限為特定數據限制，3：變數 - 依每個位元組的成本基本) 預設行為：不受限制。

描述架構屬性:

屬性名稱	屬性值
格式	`int`
存取類型	新增、刪除、取得、取代
預設值	1

允許的值:

值	描述
1 (預設)	不受限制 - 無限制的連線。
2	已修正 - 容量限制最多可達特定數據限制。
3	變數 - 按每個位元組支付基本費用。

Device/Profile/{SSID}/WlanXml

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1511 [10.0.10586] 和更新版本

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/WlanXml

描述網路設定的 XML，並遵循 Windows WLAN_profile架構。

架構的連結： https://msdn.microsoft.com/library/windows/desktop/ms707341(v=vs.85).aspx

配置檔 XML 必須逸出，如下列範例所示。

如果 keyType 和 受保護 的專案存在於 Blob 中，則必須位於 keyMaterial之前，如 WPA2-Personal 配置檔範例中的範例所示。

注意

如果您需要指定其他進階條件，例如指定 Wi-Fi 配置檔可使用的憑證準則，您可以透過 WlanXml (WLANProfile>MSM>安全>性OneX> EAPConfig) 的 EapHostConfig 部分來指定此項。如需詳細資訊，請參閱 EAP 設定和可延伸驗證通訊協定 (用於網路存取的 EAP) 。如需範例，請參閱無線配置檔範例。

描述架構屬性:

屬性名稱	屬性值
格式	`chr` (字串)
存取類型	新增、刪除、取得、取代

如需範例，請參閱新增網路。

使用者/配置檔

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1511 [10.0.10586] 和更新版本

./User/Vendor/MSFT/WiFi/Profile

描述架構屬性:

屬性名稱	屬性值
格式	`node`
存取類型	[取得]

User/Profile/{SSID}

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1511 [10.0.10586] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}

Wi-Fi 網路的配置檔名稱。當 WlanXml 節點在刪除時加入和刪除時，就會新增此專案。

如需詳細資訊，請參閱 Device/Profile/{SSID}。

描述架構屬性:

屬性名稱	屬性值
格式	`node`
存取類型	新增、刪除、取得、取代
動態節點命名	ServerGeneratedUniqueIdentifier

User/Profile/{SSID}/ProfileSource

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 11 版本 22H2 [10.0.22621] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}/ProfileSource

允許定義哪個系統管理實體設定此 Wi-Fi 配置檔。這目前可以設定為 0=Enterprise 或 1=Mobile Operator。

描述架構屬性:

屬性名稱	屬性值
格式	`int`
存取類型	取得、取代
預設值	0

允許的值:

值	描述
0 (預設值)	企業。
1	電信業者。

User/Profile/{SSID}/Proxy

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10，版本 1511 [10.0.10586] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}/Proxy

選擇性節點。格式為url：port。如果有任何) ，則會 (網路 Proxy 的設定。

注意

請勿使用。在 Windows 用戶端版本中使用此設定可能會失敗或沒有作用。請改用 NetworkProxy CSP。

描述架構屬性:

屬性名稱	屬性值
格式	`chr` (字串)
存取類型	新增、刪除、取得、取代

User/Profile/{SSID}/ProxyPacUrl

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10，版本 1607 [10.0.14393] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyPacUrl

選擇性節點。 PAC 檔案位置的 URL。

注意

請勿使用。在 Windows 用戶端版本中使用此設定可能會失敗或沒有作用。請改用 NetworkProxy CSP。

描述架構屬性:

屬性名稱	屬性值
格式	`chr` (字串)
存取類型	新增、刪除、取得、取代

User/Profile/{SSID}/ProxyWPAD

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10，版本 1607 [10.0.14393] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyWPAD

選擇性節點。欄位的存在可讓 WPAD 進行 Proxy 查閱。

注意

請勿使用。在 Windows 用戶端版本中使用此設定可能會失敗或沒有作用。請改用 NetworkProxy CSP。

描述架構屬性:

屬性名稱	屬性值
格式	`bool`
存取類型	新增、刪除、取得、取代

允許的值:

值	描述
false	停用 WPAD 以進行 Proxy 查閱。
true	啟用 WPAD 以進行 Proxy 查閱。

User/Profile/{SSID}/WiFiCost

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10 版本 1809 [10.0.17763] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}/WiFiCost

描述架構屬性:

屬性名稱	屬性值
格式	`int`
存取類型	新增、刪除、取得、取代
預設值	1

允許的值:

值	描述
1 (預設)	不受限制 - 無限制的連線。
2	已修正 - 容量限制最多可達特定數據限制。
3	變數 - 按每個位元組支付基本費用。

User/Profile/{SSID}/WlanXml

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ IoT 企業版 / IoT 企業版 LTSC	✅Windows 10，版本 1511 [10.0.10586] 和更新版本

./User/Vendor/MSFT/WiFi/Profile/{SSID}/WlanXml

描述網路設定的 XML，並遵循 Windows WLAN_profile架構。

架構的連結： https://msdn.microsoft.com/library/windows/desktop/ms707341(v=vs.85).aspx

如需詳細資訊，請參閱 Device/Profile/{SSID}/WlanXml。

描述架構屬性:

屬性名稱	屬性值
格式	`chr` (字串)
存取類型	新增、刪除、取得、取代

範例

這些 XML 範例示範如何使用 OMA DM 執行各種工作。

新增網路

下列範例示範如何新增具有 SSID 的 WPA2-Enterprise 網路，以及使用 PEAP-MSCHAPv2 進行驗證的配置檔名稱 MyNetwork 。此範例是以 WPA2-Enterprise 的範例配置檔為基礎，其中包含 PEAP-MSCHAPv2 配置檔範例。

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Atomic>
      <CmdID>301</CmdID>
      <Add>
        <CmdID>302</CmdID>
        <Item>
          <Target>
            <LocURI>./Vendor/MSFT/WiFi/Profile/MyNetwork/WlanXml</LocURI>
          </Target>
          <Meta>
            <Format xmlns="syncml:metinf">chr</Format>
          </Meta>
          <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>MyNetwork</name><SSIDConfig><SSID><hex>4d794e6574776f726b</hex><name>MyNetwork</name></SSID><nonBroadcast>false</nonBroadcast></SSIDConfig><connectionType>ESS</connectionType><connectionMode>manual</connectionMode><MSM><security><authEncryption><authentication>WPA2</authentication><encryption>AES</encryption><useOneX>true</useOneX></authEncryption><OneX xmlns="http://www.microsoft.com/networking/OneX/v1"><authMode>user</authMode><EAPConfig><EapHostConfig xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><EapMethod><Type xmlns="http://www.microsoft.com/provisioning/EapCommon">25</Type><VendorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorId><VendorType xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorType><AuthorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</AuthorId></EapMethod><Config xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><Eap xmlns="http://www.microsoft.com/provisioning/BaseEapConnectionPropertiesV1"><Type>25</Type><EapType xmlns="http://www.microsoft.com/provisioning/MsPeapConnectionPropertiesV1"><ServerValidation><DisableUserPromptForServerValidation>true</DisableUserPromptForServerValidation><ServerNames></ServerNames></ServerValidation><FastReconnect>true</FastReconnect><InnerEapOptional>false</InnerEapOptional><Eap xmlns="http://www.microsoft.com/provisioning/BaseEapConnectionPropertiesV1"><Type>26</Type><EapType xmlns="http://www.microsoft.com/provisioning/MsChapV2ConnectionPropertiesV1"><UseWinLogonCredentials>false</UseWinLogonCredentials></EapType></Eap><EnableQuarantineChecks>false</EnableQuarantineChecks><RequireCryptoBinding>false</RequireCryptoBinding><PeapExtensions><PerformServerValidation xmlns="http://www.microsoft.com/provisioning/MsPeapConnectionPropertiesV2">false</PerformServerValidation><AcceptServerName xmlns="http://www.microsoft.com/provisioning/MsPeapConnectionPropertiesV2">false</AcceptServerName></PeapExtensions></EapType></Eap></Config></EapHostConfig></EAPConfig></OneX></security></MSM></WLANProfile>]]></Data>
        </Item>
      </Add>
    </Atomic>
    <Final/>
  </SyncBody>
</SyncML>

下列範例示範如何新增具有配置檔名稱 My Network 的 WPA3-Enterprise 網路，以及使用EAP-TLS 進行驗證的SSID MySSID 。此範例是以 WPA2-Enterprise 的範例配置檔搭配 TLS 配置檔範例為基礎。

重要

請注意空間如何在 LocURI 中 %逸出，並在中 WLANProfile>name未逸出。

<Atomic>
  <CmdID>300</CmdID>
  <Add>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/My%20Network/WlanXml</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>My Network</name><SSIDConfig><SSID><name>MySSID</name></SSID></SSIDConfig><connectionType>ESS</connectionType><connectionMode>auto</connectionMode><MSM><security><authEncryption><authentication>WPA3ENT</authentication><encryption>AES</encryption><useOneX>true</useOneX></authEncryption><PMKCacheMode>enabled</PMKCacheMode><PMKCacheTTL>720</PMKCacheTTL><PMKCacheSize>128</PMKCacheSize><preAuthMode>disabled</preAuthMode><OneX xmlns="http://www.microsoft.com/networking/OneX/v1"><authMode>machine</authMode><EAPConfig><EapHostConfig xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><EapMethod><Type xmlns="http://www.microsoft.com/provisioning/EapCommon">13</Type><VendorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorId><VendorType xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorType><AuthorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</AuthorId></EapMethod><Config xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><Eap xmlns="http://www.microsoft.com/provisioning/BaseEapConnectionPropertiesV1"><Type>13</Type><EapType xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV1"><CredentialsSource><CertificateStore><SimpleCertSelection>true</SimpleCertSelection></CertificateStore></CredentialsSource><ServerValidation><DisableUserPromptForServerValidation>true</DisableUserPromptForServerValidation><ServerNames></ServerNames><TrustedRootCA>00 11 22 33 44 55 66 77 88 99 aa bb cc dd ee ff 00 11 22 33</TrustedRootCA></ServerValidation><DifferentUsername>false</DifferentUsername><PerformServerValidation xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2">true</PerformServerValidation><AcceptServerName xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2">false</AcceptServerName><TLSExtensions xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2"><FilteringInfo xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV3"><AllPurposeEnabled>false</AllPurposeEnabled><CAHashList Enabled="true"><IssuerHash>00112233445566778899aabbccddeeff00112233</IssuerHash></CAHashList><EKUMapping><EKUMap><EKUName>Client Authentication</EKUName><EKUOID>1.3.6.1.5.5.7.3.2</EKUOID></EKUMap></EKUMapping><ClientAuthEKUList Enabled="true"><EKUMapInList><EKUName>Client Authentication</EKUName></EKUMapInList></ClientAuthEKUList></FilteringInfo></TLSExtensions></EapType></Eap></Config></EapHostConfig></EAPConfig></OneX></security></MSM></WLANProfile>]]></Data>
    </Item>
  </Add>
</Atomic>

下列範例示範如何使用配置檔名稱和包含複雜TestPassword1!密碼的 SSIDMyNetwork，) 網路新增 WPA3-Personal (轉換模式。此範例是以 WPA3-Personal 的範例配置檔搭配轉換模式配置檔範例為基礎。

<Atomic>
  <CmdID>300</CmdID>
  <Add>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/MyNetwork/WlanXml</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>MyNetwork</name><SSIDConfig><SSID><name>MyNetwork</name></SSID></SSIDConfig><connectionType>ESS</connectionType><connectionMode>auto</connectionMode><MSM><security><authEncryption><authentication>WPA3SAE</authentication><encryption>AES</encryption><useOneX>false</useOneX><transitionMode xmlns="http://www.microsoft.com/networking/WLAN/profile/v4">true</transitionMode></authEncryption><sharedKey><keyType>passPhrase</keyType><protected>false</protected><keyMaterial>TestPassword1!</keyMaterial></sharedKey></security></MSM></WLANProfile>]]></Data>
    </Item>
  </Add>
</Atomic>

查詢網路配置檔

下列範例示範如何查詢安裝在 MDM 伺服器上的 Wi-Fi 設定檔。

<Get>
   <CmdID>301</CmdID>
   <Item>
      <Target>
         <LocURI>./Vendor/MSFT/WiFi/Profile</LocURI>
      </Target>
   </Item>
</Get>

下列範例顯示回應。

<Results>
   <CmdID>3</CmdID>
   <MsgRef>1</MsgRef>
   <CmdRef>301</CmdRef>
   <Item>
      <Source><LocURI>./Vendor/MSFT/WiFi/Profile</LocURI></Source>
      <Meta><Format xmlns="syncml:metinf">node</Format></Meta>
      <Data>TestWLAN1/TestWLAN2</Data>
   </Item>
</Results>

拿掉網路

下列範例示範如何移除具有 SSID MyNetwork 且沒有 Proxy 的網路。拿掉所有網路驗證類型的方式相同。

<Atomic>
  <CmdID>300</CmdID>
  <Delete>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/MyNetwork/WlanXml</LocURI>
      </Target>
    </Item>
  </Delete>
</Atomic>

共用方式為

WiFi CSP

裝置/配置檔

Device/Profile/{SSID}

Device/Profile/{SSID}/ProfileSource

Device/Profile/{SSID}/Proxy

Device/Profile/{SSID}/ProxyPacUrl

Device/Profile/{SSID}/ProxyWPAD

Device/Profile/{SSID}/WiFiCost

Device/Profile/{SSID}/WlanXml

使用者/配置檔

User/Profile/{SSID}

User/Profile/{SSID}/ProfileSource

User/Profile/{SSID}/Proxy

User/Profile/{SSID}/ProxyPacUrl

User/Profile/{SSID}/ProxyWPAD

User/Profile/{SSID}/WiFiCost

User/Profile/{SSID}/WlanXml

範例

新增網路

查詢網路配置檔

拿掉網路

相關文章

意見反應

其他資源