共用方式為

w7 APPLICATION CSP

  • 發行項

下表顯示 Windows 的適用性：

版本 Windows 10 Windows 11
Home 是 是
專業版 是 是
Windows SE 否 是
商務 是 是
企業 是 是
教育版 是 是

APPID 為 w7 的應用程式組態服務提供者可用來啟動具有 OMA DM 帳戶的裝置。 雖然此設定服務提供者是用來設定 OMA DM 帳戶，但它是透過 OMA 用戶端布建來管理。

注意

此設定服務提供者需要從網路組態應用程式存取ID_CAP_CSP_FOUNDATION和ID_CAP_DEVICE_MANAGEMENT_ADMIN功能。

以下顯示 OMA 用戶端布建所使用的樹狀結構格式設定服務提供者。

APPLICATION
---APPADDR
------ADDR
------ADDRTYPE
------PORT
---------PORTNBR
---APPAUTH
------AAUTHDATA
------AAUTHLEVEL
------AAUTHNAME
------AAUTHSECRET
------AAUTHTYPE
---AppID
---BACKCOMPATRETRYDISABLED
---CONNRETRYFREQ
---DEFAULTENCODING
---INIT
---INITIALBACKOFTIME
---MAXBACKOFTIME
---NAME
---PROTOVER
---PROVIDER-ID
---ROLE
---TO-NAPID
---USEHWDEVID
---SSLCLIENTCERTSEARCHCRITERIA

注意

所有參數名稱和特性類型都區分大小寫，而且必須使用所有大寫。 布建 XML 時必須同時提供 APPSRV 和 CLIENT 認證。

APPADDR w7 APPLICATION 特性中會使用這個特性來指定 DM 伺服器位址。

APPADDR/ADDR 選。 ADDR 參數用於 APPADDR 特性，以取得或設定 OMA DM 伺服器的位址。 此參數接受字串值。

APPADDR/ADDRTYPE 選。 ADDRTYPE 參數用於APPADDR特性，以取得或設定ADDR參數的格式。 此參數接受字串值。

在 OMA DM XML 中，如果這個參數有多個實例，則會使用第一個有效的參數值。

APPADDR/PORT 此特性用於 APPADDR 特性，以指定埠資訊。

APPADDR/PORT/PORTNBR 必填。 PORTNBR 參數用於埠特性，以取得或設定要連線的埠數目。 此參數採用字串格式的數值。

APPAUTH w7 APPLICATION 特性中會使用這個特性來指定驗證資訊。

APPAUTH/AAUTHDATA 選。 AAUTHDATA 參數用於APPAUTH特性，以取得或設定用於驗證的更多數據。 此參數用來傳達摘要式驗證類型的 nonce。 此參數接受字串值。 此參數的值是以一系列位元組形式編碼的base64。 如果 AAUTHTYPE 是 DIGEST，這個值會在 MD5 哈希計算中當做 nonce 值使用，而且在伺服器端和裝置端計算哈希時，應該使用二進位數據的八進位形式。

APPAUTH/AAUTHLEVEL 必填。 AAUTHLEVEL 參數用於APPAUTH特性，以指出認證是用於伺服器驗證或客戶端驗證。 此參數接受字串值。 您可以設定此值。

有效值：

  • APPSRV - 指定用戶端在 DM 通訊協定層級向 OMA DM 伺服器驗證本身。

  • CLIENT - 指定伺服器在 DM 通訊協定層級向 OMA DM 用戶端驗證本身。

APPAUTH/AAUTHNAME 選。 AAUTHNAME 參數用於APPAUTH特性，以區分 OMA DM 用戶端名稱。 此參數接受字串值。 您可以設定此值。

APPAUTH/AAUTHSECRET 必填。 AAUTHSECRET 參數用於APPAUTH特性，以取得或設定用來驗證使用者的驗證秘密。 此參數接受字串值。

APPAUTH/AAUTHTYPE 選。 APPAUTH 特性 AAUTHTYPE 參數可用來取得或設定驗證方法。 此參數接受字串值。

有效值：

  • BASIC - 指定 SyncML DM 'syncml：auth-basic' 驗證類型。
  • DIGEST - 指定 SyncML DM 'syncml：auth-md5' 驗證類型。
  • 當 AAUTHLEVEL 是 CLIENT 時，AAUTHTYPE 必須是 DIGEST。 當 AAUTHLEVEL 是 APPSRV 時，AAUTHTYPE 可以是 BASIC 或 DIGEST。

APPID 必填。 APPID 參數用於APPLICATION特性，以區分可用應用程式服務和通訊協定的類型。 此參數接受字串值。 您可以取得或設定此值。 設定 OMA 用戶端布建啟動程式 APPID 的唯一有效值是 w7。

BACKCOMPATRETRYDISABLED 選。 BACKCOMPATRETRYDISABLED 參數用於APPLICATION特性，以指定是否要重試重新傳送具有較舊通訊協定版本的套件 (例如，SyncHdr中的1.1) (不包括第一次) 。

注意

此參數不包含值。 此參數的存在表示已停用回溯相容性重試。 如果遺漏參數，表示已啟用回溯相容性重試。

CONNRETRYFREQ 選。 CONNRETRYFREQ 參數用於APPLICATION特性，以指定當發生 連線管理員 層級或 WinInet 層級錯誤時，DM 用戶端執行的重試次數。 此參數採用字串格式的數值。 預設值為 “3”。 您可以設定此參數。

DEFAULTENCODING 選。 DEFAULTENCODING 參數用於APPLICATION特性，以指定 DM 用戶端在與伺服器通訊時，是否應該使用WBXML或 XML 作為 DM 封裝。 您可以取得或設定此參數。

有效值為：

  • application/vnd.syncml.dm+xml (預設)
  • application/vnd.syncml.dm+wbxml

Init 選。 INIT 參數用於APPLICATION特性，表示管理伺服器希望客戶端在設定核准之後立即起始管理會話。 如果目前的 w7 APPLICATION 檔將放在 ROM 中，則 INIT 參數不得存在。

注意

此節點僅適用於嘗試使用此節點的電信業者和 MDM 伺服器將會失敗。 企業 MDM 註冊案例不支援此節點。 此參數會強制裝置嘗試與 OMA DM 伺服器連線。 如果在 coldinit 階段期間設定 XML，則連線嘗試會失敗。 此失敗的常見原因是在 coldinit 完成之後，無線電尚未就緒。

  INITIALBACKOFFTIME 選。 INITIALBACKOFFTIME 參數用於APPLICATION特性，以指定 DM 用戶端第一次重試時的初始等候時間，以毫秒為單位。 等候時間會以指數方式成長。 此參數採用字串格式的數值。 預設值為 “16000”。 您可以取得或設定此參數。

MAXBACKOFFTIME 選。 MAXBACKOFFTIME 參數用於APPLICATION特性，以指定封裝傳送失敗後要睡眠的最大毫秒數。 此參數採用字串格式的數值。 預設值為 “86400000”。 您可以設定此參數。

名字 選。 NAME 參數用於 APPLICATION 特性，以指定使用者可讀取的應用程式身分識別。 此參數可用來定義APPLICATION參數的部分登錄路徑。 您可以設定此參數。

NAME 參數可以是字串或 null (沒有值) 。 如果未指定任何值，則登錄位置預設為 <未命名>。

PROTOVER 選。 PROTOVER 參數用於APPLICATION特性，以指定伺服器支援的OMA DM通訊協定版本。 未假設預設值。 此節點所設定的通訊協定版本將符合 DM 用戶端在套件 1 中向 SyncHdr 中伺服器回報的通訊協定版本。 如果在新增 DM 伺服器帳戶時未指定此節點，則會使用用戶端支援的最新 DM 通訊協定版本。 在 Windows Phone 中，此版本為 1.2。 此參數是 Microsoft 自定義參數。 您可以設定此參數。

可能的值：

  • 1.1
  • 1.2

PROVIDER-ID 選。 PROVIDER-ID 參數用於APPLICATION特性，以區分 OMA DM 伺服器。 它會指定目前管理會話中所使用之管理伺服器的伺服器識別碼。 此參數接受字串值。 您可以設定此參數。

作用 選。 ROLE 參數用於 APPLICATION 特性，以指定 DM 工作階段在與 DM 伺服器通訊時應該與之一起執行的安全性應用程式。 唯一支援的角色是 8 個 (電信業者) 和 32 個 (企業) 。 如果此參數不存在，則會採用電信業者角色。 企業角色只能由企業註冊客戶端設定。 企業客戶端無法設定電信業者角色。 此參數是 Microsoft 自定義參數。 此參數採用字串格式的數值。 您可以取得或設定此參數。

TO-NAPID 選。 TO-NAPID 參數用於 APPLICATION 特性，以指定用戶端將用來連線到 OMA DM 伺服器的網路存取點。 如果指定了多個 TO-NAPID 參數，則只會儲存第一個 TO-NAPID 值。 此參數接受字串值。 您可以設定此參數。

USEHWDEVID 選。 USEHWDEVID 參數用於APPLICATION特性，以指定使用裝置硬體識別。 它沒有值。

  • 如果參數不存在，預設行為是使用使用的應用程式特定 GUID，而不是硬體裝置識別碼。
  • 如果參數存在，硬體裝置標識碼會在 ./DevInfo/DevID 節點和傳送至伺服器之 DM 套件的來源 LocURI 中提供。 會針對 GSM 裝置傳回國際行動訂閱者身分識別 (IMEI) 。

SSLCLIENTCERTSEARCHCRITERIA 選。 SSLCLIENTCERTSEARCHCRITERIA 參數用於APPLICATION特性，以指定客戶端憑證搜尋準則。 此參數支援依主體屬性和證書存儲進行搜尋。 如果提供任何其他準則，則會予以忽略。

字串是名稱/值組的串連，每個成員的配對都是以 “&” 字元分隔。 名稱和值會以 「=」 字元分隔。 如果有多個值，每個值都會以 Unicode 字元 「U+F000」 分隔。 如果名稱或值包含的字元不在 UNRESERVED 集合中， (如RFC2396) 中所指定，則這些字元會根據 RFC 逸出 URI。

支援的名稱為 Subject 和 Store;不支援通配符憑證搜尋。

Store 會指定 DM 用戶端將搜尋哪些憑證來尋找 SSL 用戶端憑證。 有效的存放區值為 My%5CUser。 商店名稱不區分大小寫。   主體會指定要搜尋的憑證。 例如，若要指定您想要具有特定 Subject 屬性的憑證 (“CN=Tester，O=Microsoft”) ，請使用下列專案：

注意

%EF%80%80 是UTF8編碼字元U+F000。

<parm name="SSLCLIENTCERTSEARCHCRITERIA"
   value="Subject=CN%3DTester,O%3DMicrosoft&amp;Stores=My%5CUser" />

設定服務提供者參考