EnterpriseModernAppManagem...

文章推薦指數: 80 %
投票人數:10人

瞭解EnterpriseModernAppManagement (CSP) 如何用於布備及報告新式企業應用程式。

跳到主要內容 已不再支援此瀏覽器。

請升級至MicrosoftEdge,以利用最新功能、安全性更新和技術支援。

下載MicrosoftEdge 其他資訊 目錄 結束焦點模式 閱讀英文 儲存 意見反應 編輯 共用 Twitter LinkedIn Facebook 電子郵件 WeChat 目錄 閱讀英文 儲存 目錄 閱讀英文 儲存 意見反應 編輯 Twitter LinkedIn Facebook 電子郵件 WeChat 目錄 EnterpriseModernAppManagementCSP 發行項 12/18/2021 1位參與者 此頁面有所助益嗎? Yes No 還有其他意見反應嗎? 系統會將意見反應傳送給Microsoft:按下[提交]按鈕,您的意見反應將用來改善Microsoft產品和服務。

隱私權原則。

送出 謝謝。

本文內容 EnterpriseModernAppManagement組(CSP)會用於布備及報告新式企業應用程式。

若要瞭解如何使用此CSP來報告應用程式庫存、使用者應用程式的安裝和移除、將應用程式佈建至裝置,以及管理應用程式授權等詳細資料,請參閱應用程式管理Enterprise>。

注意 Windows全圖僅支援EnterpriseModernAppManagementCSP的每個使用者組組。

以下以樹格式顯示EnterpriseModernAppManagement組式服務提供者。

./Vendor/MSFT EnterpriseModernAppManagement ----AppManagement --------EnterpriseID ------------PackageFamilyName ----------------PackageFullName --------------------Name --------------------Version --------------------Publisher --------------------Architecture --------------------InstallLocation --------------------IsFramework --------------------IsBundle --------------------InstallDate --------------------ResourceID --------------------PackageStatus --------------------RequiresReinstall --------------------Users --------------------IsProvisioned ----------------DoNotUpdate ----------------AppSettingPolicy --------------------SettingValue --------UpdateScan --------LastScanError --------AppInventoryResults --------AppInventoryQuery ----AppInstallation --------PackageFamilyName ------------StoreInstall ------------HostedInstall ------------LastError ------------LastErrorDesc ------------Status ------------ProgressStatus ----AppLicenses --------StoreLicenses ------------LicenseID ----------------LicenseCategory ----------------LicenseUsage ----------------RequesterID ----------------AddLicense ----------------GetLicenseFromStore 裝置或使用者上下文 針對使用者上下文,請使用./User/Vendor/MSFT路徑,針對裝置上下文,請使用./Device/Vendor/MSFT路徑。

注意 Windows全圖僅支援EnterpriseModernAppManagementCSP的每個使用者組組。

AppManagement 必要。

用於庫存與應用程式管理(安裝後)。

AppManagement/UpdateScan 必要。

用來啟動更新Windows掃描。

支援的操作為執行。

AppManagement/LastScanError 必要。

報告更新掃描所返回的最後一個錯誤碼。

支援的操作為[取得]。

AppManagement/AppInventoryResults 已新增Windows10版本1511。

必要。

會返回AppInventoryQuery作業之後所建立的應用程式庫存結果。

支援的操作為[取得]。

以下是AppInventoryResults運算的範例。

11 ./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryResults AppManagement/AppInventoryQuery 已新增Windows10版本1511。

必要。

指定應用程式庫存的查詢。

查詢參數: 輸出-指定AppInventoryResults運算中所返回之資訊的參數。

多個值必須以不同的|。

有效值為: PackageName-傳回App的PackageFamilyName和PackageFullName。

如果未指定任何專案,則預設。

PackageDetails-會返回套件的所有庫存屬性。

這包括PackageNames參數的所有資訊,但無法驗證RequiresReinstall。

RequiredReinstall-驗證庫存查詢中App的應用程式狀態,以判斷它們是否需要重新安裝。

此屬性可能會影響系統性能,視已安裝的應用程式數量而不同。

當資源套件更新或應用程式在竄改狀態時,會要求重新安裝。

來源-指定與現有庫存節點對齊的應用程式分類。

您可以使用特定的篩選,或者如果沒有指定篩選,則會返回所有來源。

如果未指定值,會返回所有分類。

有效值為: AppStore-此分類適用于從MicrosoftStore取得的應用程式。

這些應用程式是直接從MicrosoftStore或企業應用程式從商務用MicrosoftStore。

nonStore-此分類適用于未從MicrosoftStore取得的應用程式。

系統-屬於作業系統的App。

您無法卸載這些應用程式。

此分類為唯讀,且只能列出庫存。

PackageTypeFilter-指定一或多種可用於查詢使用者或裝置之套件類型。

多個值必須以多個|。

有效值為: Main-會返回安裝的主要套件。

Bundle-會返回已安裝的套件。

Framework-會返回已安裝的框架套件。

Resource-會返回已安裝的資源套件。

資源是語言、縮放或DirectX資源。

它們是套件的一部分。

XAP-會返回XAP封裝類型。

此篩選僅在行動Windows支援。

All-會返回所有套件類型。

如果未指定值,會返回Main、Bundle和Framework的組合。

PackageFamilyName-指定特定套件的名稱。

如果您指定此參數,如果套件包含此值,它會返回套件家庭名稱。

如果您未指定此值,則會返回所有套件。

Publisher-指定特定套件的發行者。

如果您指定此參數,如果值存在於Publisher欄位中,它會Publisher發行者。

如果您未指定此值,則會返回所有發行者。

支援的作業是取得和取代。

下列範例會設定套件名稱的庫存查詢,並檢查非StoreApp中所有主要套件的重新安裝狀態。

10 ./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryQuery xml AppManagement/RemovePackage Windows10(版本1703)中的新功能。

用來移除套件。

不支援./User/Vendor/MSFT。

參數: 套件 名稱:指定要移除之特定套件的PackageFullName。

RemoveForAllUsers: 0(預設)-套件會取消配置,讓新使用者不會收到套件。

目前使用者仍然會安裝套件。

目前不支援此功能。

1–只有在套件為已部署套件時,所有使用者才能移除套件。

使用者(選擇性):指定要移除套件的特定使用者的SID;只能移除指定使用者的套件。

支援的操作為執行。

下列範例會移除所有使用者的套件: 10 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/RemovePackage xml AppManagement/nonStore 用來管理未從應用程式取得的企業MicrosoftStore。

支援的操作為[取得]。

AppManagement/System 報告在作業系統中安裝的App。

支援的操作為[取得]。

AppManagement/AppStore 必要。

用於管理應用程式MicrosoftStore。

支援的作業為取得和刪除。

AppManagement/AppStore/ReleaseManagement 新增到Windows10版本1809。

內部節點,用於透過MicrosoftStore。

這些設定允許IT系統管理員為使用者用於接收更新的應用程式指定更新通道。

它可讓IT系統管理員將特定發行指派給較小的群組進行測試,然後再將大型部署指派給組織的其餘部分。

注意 發行管理設定僅適用于透過更新MicrosoftStore。

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey__ 新增到Windows10版本1809。

應用程式或一組應用程式的識別碼。

如果只有一個應用程式,它是PackageFamilyName。

如果是一組應用程式,則它是主應用程式的PackageFamilyName。

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/ChannelId 新增到Windows10版本1809。

指定應用程式通道識別碼。

值類型為字串。

支援的操作包括新增、取得、取代和刪除。

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/ReleaseManagementId 新增到Windows10版本1809。

IT系統管理員可以指定發行識別碼,以指出使用者或裝置要啟用的特定發行。

值類型為字串。

支援的操作包括新增、取得、取代和刪除。

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/EffectiveRelease 新增到Windows10版本1809。

內部節點,用來指定在裝置上設定多個使用者策略時,要使用的有效應用程式發行。

使用裝置策略或最後一個使用者策略。

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/EffectiveRelease/ChannelId 新增到Windows10版本1809。

會返回裝置上最後一個使用者通道識別碼。

值類型為字串。

支援的操作為[取得]。

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/EffectiveRelease/ReleaseManagementId 新增到Windows10版本1809。

會返回裝置上最後一個使用者版本識別碼。

值類型為字串。

支援的操作為[取得]。

.../PackageFamilyName 選用。

將家庭名稱(PFN)應用程式。

報告庫存時,裝置上每個PFN都有一個。

這些專案會根據其簽署來源。

支援的作業為取得和刪除。

注意 XAP檔案使用產品識別碼來表示PackageFamilyName。

以下是XAP產品識別碼的範例,(大括弧{12345678-9012-3456-7890-123456789012})。

以下是卸載應用程式的範例: 2 ./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D **.../PackageFamilyName/**PackageFullName 選用。

已安裝套件的完整名稱。

支援的作業為取得和刪除。

注意 XAP檔案會使用產品識別碼來表示PackageFullName。

以下是XAP產品識別碼的範例,(大括弧{12345678-9012-3456-7890-123456789012})。

.../PackageFamilyName/PackageFullName/Name 必要。

應用程式名稱。

值類型為字串。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/Version 必要。

應用程式版本。

值類型為字串。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/Publisher 必要。

Publisher應用程式的名稱。

值類型為字串。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/Architecture 必要。

已安裝套件的架構。

值類型為字串。

注意 不適用於XAP檔案。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/InstallLocation 必要。

在裝置上安裝應用程式的位置。

值類型為字串。

注意 不適用於XAP檔案。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/IsFramework 必要。

應用程式是否為架構套件。

數值型別為int。

如果應用程式是架構套件,則值為1,而所有其他(值為0)為零。

注意 不適用於XAP檔案。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/IsBundle 必要。

如果套件是應用程式套件,則值為1,所有其他情況(0)為零。

數值型別為int。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/InstallDate 必要。

應用程式安裝日期。

值類型為字串。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/ResourceID 必要。

應用程式的資源識別碼。

此為主應用程式為Null,~適用于套件,且包含資源套件的資源資訊。

值類型為字串。

注意 不適用於XAP檔案。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/PackageStatus 必要。

提供有關套件狀態的資訊。

數值型別為int。

有效的值為: 確定(0)-套件可用。

授權:(1)-套件授權無效。

已修改(2)-套件負載已由未知的來源修改。

已竄(4)-套件有效負載遭到故意竄改。

已停用(8)-此套件無法使用。

它仍然可以維修。

注意 不適用於XAP檔案。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/RequiresReinstall 必要。

指定套件狀態是否已變更,且需要重新安裝應用程式。

當需要新的應用程式資源時,例如當裝置的語言喜好設定變更或新的DPI時,可能會發生此情況。

它也可以發生套件已損壞。

如果值為1,即會執行重新安裝應用程式。

數值型別為int。

注意 不適用於XAP檔案。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/Users 必要。

應用程式的註冊使用者和套件安裝狀態。

如果查詢位於裝置層級,它會會返回裝置的所有已註冊使用者。

如果您查詢使用者上下文,只會返回目前的使用者。

值類型為字串。

未安裝=0 階段=1 已安裝=2 已暫停=6 支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/IsProvisioned 必要。

該值為0或1,表示裝置上是否配置了應用程式。

數值型別為int。

支援的操作為[取得]。

.../PackageFamilyName/PackageFullName/IsStub 已新增Windows10版本2004。

必要。

此節點是用來識別套件是否存根套件。

存根套件是套件的版本,其最小功能可縮減應用程式的大小。

如果套件是存根套件,值為1,所有其他情況(0)為零。

數值型別為int。

支援的操作為[取得]。

.../PackageFamilyName/DoNotUpdate 必要。

指定是否要透過自動更新來封鎖特定應用程式。

支援的操作包括新增、取得、刪除和取代。

.../PackageFamilyName/AppSettingPolicy(僅適用于./User/Vendor/MSFT) 已新增Windows10版本1511。

所有受管理應用程式設定值的內部節點。

此節點僅支援使用者上下文。

.../PackageFamilyName/AppSettingPolicy/settingValue(僅適用于./User/Vendor/MSFT) 已新增Windows10版本1511。

SettingValue和資料代表要針對應用程式設定的索引碼組。

節點代表金鑰的名稱,而資料代表值。

您可以在本文的LocalSettings中Managed.App。

設定容器。

此設定僅適用于支援此功能的應用程式,且僅支援使用者上下文。

值類型為字串。

支援的操作包括新增、取得、取代和刪除。

下列範例會設定'Server'的值 0 ./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy/Server chr server1.contoso.com 下列範例會獲得特定應用程式的所有受管理應用程式設定。

0 ./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy?list=StructData .../PackageFamilyName/MaintainProcessorArchitectureOnUpdate Windows10(版本1803)中的新功能。

指定在AMD64裝置上,跨應用程式更新,安裝應用程式的架構是否不得變更。

例如,如果您已安裝x86Windows應用程式,並啟用這項設定,則即使x64風格可供使用,x86風格也會在整個更新中安裝。

支援的操作包括新增、取得、刪除和取代。

值類型為整數。

已安裝x86風格App的AMD64電腦上的預期行為(限制)。

可適用性設定 CSP狀態 結果 True 未設定 X86風格已挑選 True 啟用 X86風格已挑選 True 停用 X86風格已挑選 未(錯誤) 未設定 X64風格已挑選 .../PackageFamilyName/NonRemovable 新增到Windows10版本1809。

指定使用者是否無法移動應用程式。

此設定可讓IT系統管理員將應用程式設定為無法移動,或使用者無法卸載。

這項功能在企業與教育情境中非常實用,IT系統管理員可能想要確保每個人都擁有特定應用程式,而且不會意外移除這些App。

當每個裝置有多個使用者,而且您想要確保一個使用者不會移除所有使用者的使用者時,這項功能也很有用。

無法移動需要系統管理員許可權。

這只能設定為每個裝置,而不是每個使用者。

您可以使用AppInventoryQuery或AppInventoryResults查詢設定。

值類型為整數。

支援的操作為新增、取得和取代。

有效值: 0–應用程式不在無法移動的應用程式策略清單中 1–應用程式包含在無法移動的應用程式策略清單中 範例: 將應用程式新增到無法移動的應用程式策略清單 1 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable int 1 取得特定應用程式的狀態 1 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable 在無法移動的應用程式策略清單中取代應用程式 資料0=應用程式不在應用程式策略清單中 資料1=應用程式位於應用程式策略清單中 1 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable int 0 AppInstallation 必要的節點。

用來執行App安裝。

AppInstallation/PackageFamilyName 選擇性節點。

將家庭名稱(PFN)應用程式。

報告庫存時,裝置上每個PFN都有一個。

這些專案會根據其簽署來源。

支援的操作為[取得]和[新增]。

注意 XAP檔案使用產品識別碼來表示PackageFamilyName。

以下是XAP產品識別碼的範例,(大括弧{12345678-9012-3456-7890-123456789012})。

AppInstallation/PackageFamilyName/StoreInstall 必要。

命令,以執行App的安裝,以及來自MicrosoftStore。

支援的操作為執行、新增、刪除和取得。

AppInstallation/PackageFamilyName/HostedInstall 必要。

從託管位置執行應用程式套件安裝的命令(可以是本地磁碟機、UNC或HTTPs資料來源)。

下列清單顯示支援的部署選項: ForceApplicationShutdown DevelopmentMode InstallAllResources ForceTargetApplicationShutdown ForceUpdateToAnyVersion DeferRegistration="1"。

如果App在安裝時使用中。

這會階段應用程式更新的檔案,並完成應用程式關閉後的應用程式更新註冊。

適用于20H1的最新內部人員航班。

StageOnly="1"。

在不安裝應用程式的情況下,將應用程式安裝或更新的檔案階段。

1803年提供。

LicenseUri="\server\license.lic"。

從伺服器部署離線商務用MicrosoftStore。

1607提供。

驗證Dependencies="1"。

這是在部署/暫存時間使用。

如果設為1,部署將在分段期間執行與我們在註冊時通常會執行相同的相依性驗證,如果相依性不存在,則失敗並拒絕提供要求。

適用于20H1的最新內部人員航班。

ExcludeAppFromLayoutModification="1"。

設定應用程式將配置在所有裝置上,並能夠保留已置備的應用程式,而不需要將它們釘釘到開始版面配置。

1809年提供。

支援的操作為執行、新增、刪除和取得。

AppInstallation/PackageFamilyName/LastError 必要。

上次與應用程式安裝相關的錯誤。

支援的操作為[取得]。

注意 安裝應用程式後,此元素不存在。

AppInstallation/PackageFamilyName/LastErrorDesc 必要。

與應用程式安裝相關的最後一個錯誤描述。

支援的操作為[取得]。

注意 安裝應用程式後,此元素不存在。

AppInstallation/PackageFamilyName/Status 必要。

應用程式安裝的狀態。

會返回下列值: NOT_INSTALLED(0)-已新增節點,但尚未完成執行。

安裝(1)-已啟動執行,但部署尚未完成。

如果部署完成,無論成功,此值都會更新。

2(失敗-)安裝失敗。

錯誤詳細資料可在LastError和LastErrorDescription下找到。

已安裝(3)-安裝成功後,此節點會清除,不過,如果清理動作尚未完成,此狀態可能會短暫出現。

支援的操作為[取得]。

注意 安裝應用程式後,此元素不存在。

AppInstallation/PackageFamilyName/ProgessStatus 必要。

表示應用程式安裝進度的整數。

對於HTTPs位置,這表示下載進度。

ProgressStatus無法用於資源調配,而且僅適用于使用者型安裝。

在資源配置中,值一直是0(0)。

支援的操作為[取得]。

注意 安裝應用程式後,此元素不存在。

AppLicenses 必要的節點。

用來管理應用程式案例授權。

AppLicenses/StoreLicenses 必要的節點。

用來管理市面應用程式授權。

AppLicenses/StoreLicenses/LicenseID 選擇性節點。

市/市安裝的應用程式授權識別碼。

授權識別碼通常是應用程式的PFN。

支援的操作包括新增、取得和刪除。

AppLicenses/StoreLicenses/LicenseID/LicenseCategory 已新增Windows10版本1511。

必要。

用來分類各種授權來源之授權類別。

有效值: 未知-未知的授權類別 零售-透過零售通道銷售授權,通常是從零售MicrosoftStore Enterprise-透過企業銷售通道銷售授權,通常是從商務用商店銷售 OEM-授權給OEM 開發人員-開發人員授權,通常是在應用程式開發或側載案例期間安裝。

支援的操作為[取得]。

AppLicenses/StoreLicenses/LicenseID/LicenseUsage 已新增Windows10版本1511。

必要。

表示授權允許的使用量。

有效值: 未知-使用量不明 線上-授權僅適用于線上使用。

這是適用于具有並行需求的應用程式,例如用於多部電腦上的應用程式,但只能在任一時間在一部電腦上使用。

離線-授權適用于離線使用。

您不需要網際網路連接,才能使用此授權。

Enterprise根- 支援的操作為[取得]。

AppLicenses/StoreLicenses/LicenseID/RequesterID 已新增Windows10版本1511。

必要。

要求授權之實體的識別碼,例如取得授權的客戶。

例如,由商務用Store為特定企業用戶端發行的所有授權都具有相同的RequesterID。

支援的操作為[取得]。

AppLicenses/StoreLicenses/LicenseID/AddLicense 必要。

新增授權的命令。

支援的操作為執行。

AppLicenses/StoreLicenses/LicenseID/GetLicenseFromStore 已新增Windows10版本1511。

必要。

從市面取得授權的命令。

支援的操作為執行。

範例 若要瞭解如何使用此CSP來報告應用程式庫存、使用者應用程式的安裝和移除、將應用程式置備至裝置,以及管理應用程式授權等範例,請參閱應用程式管理Enterprise>。

查詢裝置的特定應用程式子類別,例如nonStoreApp。

1 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore 結果包含應用程式清單,例如App1/App2/App

特定應用程式屬性的後續查詢。

1 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/App1?list=StructData 2 ./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/App2?list=StructData 相關主題 設定服務提供者參考 意見反應 提交並檢視相關的意見反應 本產品 本頁 檢視所有頁面意見反應 本文內容



請為這篇文章評分?