WiFi CSP

發行項
08/01/2024

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 型網路，請在純文字的網路設定中包含通行密鑰。傳遞金鑰儲存在裝置上時會自動加密。
LocURI 節點 Wi-Fi 網路部分的 SSID 必須是以 RFC 2396 為基礎的有效 URI。此條件要求所有非 ASCII 字元都必須使用 %-character 逸出。不支援不需要逸出的 Unicode 字元。
<name>name_goes_here</name>\<SSIDConfig>必須符合 <SSID><name>name_goes_here</name></SSID>。
針對WiFi CSP，除非節點已經存在，否則您無法使用 Replace 命令。
在 Windows 10 用戶端版本中使用 ProxyPacUrl 或 ProxyWPAD (家用版、專業版、企業版和教育版) 會導致失敗。

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

./Device/Vendor/MSFT/WiFi
- 配置檔
  - {SSID}
    - ProfileSource
    - Proxy
    - ProxyPacUrl
    - ProxyWPAD
    - WiFiCost
    - WlanXml
./User/Vendor/MSFT/WiFi
- 配置檔
  - {SSID}
    - ProfileSource
    - Proxy
    - ProxyPacUrl
    - ProxyWPAD
    - WiFiCost
    - WlanXml

裝置/配置檔

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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}

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

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

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

指定 Wi-Fi 網路的名稱 (建立、設定、查詢或刪除的最大) 32 個字節。名稱會區分大小寫，而且可以用 ASCII 表示。

SSID 是您要連線的網路名稱，而設定檔名稱則是包含WiFi設定資訊的設定檔名稱。如果未在 MDM SyncML 中直接設定設定檔名稱，則根據 WiFi 設定 XML 中的資訊，可能會導致一些非預期的錯誤。例如，<LocURI>./Vendor/MSFT/WiFi/Profile/<MUST BE NAME OF PROFILE AS PER WIFI XML>/WlanXml</LocURI>。

描述架構屬性:

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

Device/Profile/{SSID}/ProfileSource

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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

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

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

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

描述架構屬性:

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

Device/Profile/{SSID}/ProxyPacUrl

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

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

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

注意

請勿使用。在 Windows 10 用戶端版本中使用此設定會導致失敗。

描述架構屬性:

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

Device/Profile/{SSID}/ProxyWPAD

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

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

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

注意

請勿使用。在 Windows 10 用戶端版本中使用此設定會導致失敗。

描述架構屬性:

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

允許的值:

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

Device/Profile/{SSID}/WiFiCost

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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 的 EapHostConfig 部分來指定此條件。如需詳細資訊，請參閱 EAP 設定。

描述架構屬性:

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

使用者/配置檔

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

./User/Vendor/MSFT/WiFi/Profile

描述架構屬性:

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

User/Profile/{SSID}

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

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

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

指定 Wi-Fi 網路的名稱 (建立、設定、查詢或刪除的最大) 32 個字節。名稱會區分大小寫，而且可以用 ASCII 表示。

描述架構屬性:

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

User/Profile/{SSID}/ProfileSource

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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

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

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

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

描述架構屬性:

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

User/Profile/{SSID}/ProxyPacUrl

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

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

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

注意

請勿使用。在 Windows 10 用戶端版本中使用此設定會導致失敗。

描述架構屬性:

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

User/Profile/{SSID}/ProxyWPAD

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

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

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

注意

請勿使用。在 Windows 10 用戶端版本中使用此設定會導致失敗。

描述架構屬性:

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

允許的值:

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

User/Profile/{SSID}/WiFiCost

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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

領域	版本	適用的作業系統
✅ 裝置 ✅ 使用者	✅ 專業版 ✅ 企業版 ✅ 教育版 ✅ Windows SE ✅ 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

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

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

注意

描述架構屬性:

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

範例

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

新增網路

下列範例示範如何使用 SSID 'MyNetwork' 新增 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><?xml version="1.0"?><WLANProfile xmlns="http://contoso.com/networking/WLAN/profile/v1"><name>MyNetwork</name><SSIDConfig><SSID><hex>412D4D534654574C414E</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://contoso.com/networking/OneX/v1"><authMode>user</authMode><EAPConfig><EapHostConfig xmlns="http://contoso.com/provisioning/EapHostConfig"><EapMethod><Type xmlns="http://contoso.com/provisioning/EapCommon">25</Type><VendorId xmlns="http://contoso.com/provisioning/EapCommon">0</VendorId><VendorType xmlns="http://contoso.com/provisioning/EapCommon">0</VendorType><AuthorId xmlns="http://contoso.com/provisioning/EapCommon">0</AuthorId></EapMethod><Config xmlns="http://contoso.com/provisioning/EapHostConfig"><Eap xmlns="http://contoso.com/provisioning/BaseEapConnectionPropertiesV1"><Type>25</Type><EapType xmlns="http://contoso.com/provisioning/MsPeapConnectionPropertiesV1"><ServerValidation><DisableUserPromptForServerValidation>true</DisableUserPromptForServerValidation><ServerNames></ServerNames></ServerValidation><FastReconnect>true</FastReconnect><InnerEapOptional>false</InnerEapOptional><Eap xmlns="http://contoso.com/provisioning/BaseEapConnectionPropertiesV1"><Type>26</Type><EapType xmlns="http://contoso.com/provisioning/MsChapV2ConnectionPropertiesV1"><UseWinLogonCredentials>false</UseWinLogonCredentials></EapType></Eap><EnableQuarantineChecks>false</EnableQuarantineChecks><RequireCryptoBinding>false</RequireCryptoBinding><PeapExtensions><PerformServerValidation xmlns="http://contoso.com/provisioning/MsPeapConnectionPropertiesV2">false</PerformServerValidation><AcceptServerName xmlns="http://contoso.com/provisioning/MsPeapConnectionPropertiesV2">false</AcceptServerName></PeapExtensions></EapType></Eap></Config></EapHostConfig></EAPConfig></OneX></security></MSM></WLANProfile> </Data>
        </Item>
      </Add>
    </Atomic>
    <Final/>
  </SyncBody>
</SyncML>

查詢網路配置檔

下列範例示範如何查詢安裝在 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>

新增伺服器證書的網路和證書頒發機構單位

下列範例示範如何使用 SSID 'MyNetwork' 和伺服器證書的根 CA 驗證來新增 PEAP-MSCHAPv2 網路。

<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><?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>MyNetwork</name><SSIDConfig><SSID><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><TrustedRootCA> InsertCertThumbPrintHere </TrustedRootCA></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">true</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>

設定服務提供者參考

共用方式為

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

範例

新增網路

查詢網路配置檔

拿掉網路

新增伺服器證書的網路和證書頒發機構單位

意見反應

其他資源

共用方式為

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

範例

新增網路

查詢網路配置檔

拿掉網路

新增伺服器證書的網路和證書頒發機構單位

相關文章

意見反應

其他資源