語言

AppInstallManager 類別

定義

提供成員程式化安裝應用程式的功能,包括啟動應用程式安裝及取得目前進行中的應用程式清單。

public ref class AppInstallManager sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AppInstallManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class AppInstallManager final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AppInstallManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class AppInstallManager
function AppInstallManager()
Public NotInheritable Class AppInstallManager
繼承
Object Platform::Object IInspectable AppInstallManager
屬性

Windows 需求

規格需求 Description
裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能
runFullTrust

備註

這很重要

此 API 的存取受限於 Microsoft 開發的應用程式的私有功能保護。

備註

在Windows開箱體驗(OOBE)期間,避免呼叫AppInstallManager.StartProductInstallAsync或AppInstallManager.StartProductInstallForUserAsync。

在 OOBE 完成前提出的安裝請求可能不會如預期,因為與 Store 相關的服務尚未完全初始化。

為了獲得最佳效果,請在首次使用者登入後先呼叫這些方法。

版本歷程記錄

Windows 版本 SDK 版本 增值
1511 10586 取消(String,String)
1511 10586 GetIsAppAllowedToInstallAsync(String,String,String,String,String)
1511 10586 暫停(弦,弦)
1511 10586 Restart(String,String)
1511 10586 SearchForAllUpdatesAsync(String)
1511 10586 SearchForUpdatesAsync(String, String, String, String)
1511 10586 StartAppInstallAsync(String,String,Boolean,String,String,String)
1511 10586 UpdateAppByPackageFamilyNameAsync(String,String)
1607 14393 GetIsAppAllowedToInstallForUserAsync
1607 14393 GetIsApplicableForUserAsync
1607 14393 移至下載排隊前列
1607 14393 SearchForAllUpdatesForUserAsync(User,String)
1607 14393 搜尋更新:UserAsync(User, String, String, String, String)
1607 14393 StartProductInstallAsync(String, String, String, String, String, Boolean, String, PackageVolume)
1607 14393 StartProductInstallForUserAsync(User,String,String,String,String,String,Boolean,Boolean,String,PackageVolume)
1607 14393 UpdateAppByPackageFamilyNameForUserAsync
1703 15063 AppInstallItemsWithGroupSupport
1703 15063 GetFreeDeviceEntitlementAsync
1703 15063 GetFreeUserEntitlementAsync
1703 15063 GetFreeUserEntitlementForUserAsync
1803 17134 GetIsPackageIdentityAllowedToInstallAsync
1803 17134 GetIsPackageIdentityAllowedToInstallForUserAsync
1803 17134 SearchForAllUpdatesAsync(String, String, AppUpdateOptions)
1803 17134 SearchForForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions)
1803 17134 搜尋更新自動同步(String, String, String, String, String, AppUpdateOptions)
1803 17134 SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions)
1803 17134 StartProductInstallAsync(String, String, String, String, String, AppInstallOptions)
1803 17134 StartProductInstallForUserAsync(User,String,String,String,String,String,AppInstallOptions)
1809 17763 CanInstallForAllUsers

建構函式

名稱 Description
AppInstallManager()

建立並初始化 AppInstallManager 類別的新實例。

屬性

名稱 Description
AcquisitionIdentity

取得或設定與應用程式安裝相關聯的使用者身份。

AppInstallItems

擷取目前安裝佇列中所有應用程式的資訊。

AppInstallItemsWithGroupSupport

擷取目前安裝佇列中單一應用程式套件中所有應用程式的資訊。

AutoUpdateSetting

它會取得或設定目前電腦或裝置上應用程式的自動更新設定。

CanInstallForAllUsers

取得或設定一個值,指示呼叫應用程式是否具備提升的管理員權限,以確保為所有使用者安裝應用程式都能成功。

方法

名稱 Description
Cancel(String, String)

取消安裝指定的應用程式,並可選擇產生遙測資料。

Cancel(String)

取消安裝指定的應用程式。

GetFreeDeviceEntitlementAsync(String, String, String)

授權所有目前裝置上的用戶使用該應用程式的免費權限。

GetFreeUserEntitlementAsync(String, String, String)

將指定應用程式的免費權利授予現有使用者。

GetFreeUserEntitlementForUserAsync(User, String, String, String)

將指定應用程式的免費權限授予指定使用者。

GetIsAppAllowedToInstallAsync(String, String, String, String)

判斷指定的應用程式是否有權限安裝在目前的電腦或裝置上,並可選擇產生遙測資料。

GetIsAppAllowedToInstallAsync(String)

判斷指定的應用程式是否有權限安裝在目前的電腦或裝置上。

GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String)

判斷指定的應用程式是否有權限在該使用者的當前電腦或裝置上安裝,並可選擇產生遙測資料。

GetIsApplicableAsync(String, String)

判斷該指定應用程式是否能安裝在目前的電腦或裝置上。

GetIsApplicableForUserAsync(User, String, String)

判斷指定應用程式是否能安裝在指定使用者的現有電腦或裝置上。

GetIsPackageIdentityAllowedToInstallAsync(String, String, String)

回傳一個值,指示是否允許安裝包含指定身份資訊的套件於目前裝置上。

GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String)

回傳一個值,指示是否允許該裝置安裝包含指定身份資訊的套件。

IsStoreBlockedByPolicyAsync(String, String)

判斷該指定應用程式是否被目前電腦或裝置的政策封鎖。

MoveToFrontOfDownloadQueue(String, String)

將指定的應用程式移到下載隊列的最前面。

Pause(String, String)

暫停安裝指定的應用程式,並可選擇產生遙測資料。

Pause(String)

暫停指定的應用程式安裝。

Restart(String, String)

重新啟動指定的應用程式安裝,並選擇產生遙測資料。

Restart(String)

重新啟動指定的應用程式安裝。

SearchForAllUpdatesAsync()

搜尋目前電腦或裝置上安裝的所有應用程式更新。

SearchForAllUpdatesAsync(String, String, AppUpdateOptions)

搜尋目前電腦或裝置上安裝的應用程式所有可用更新,並可強制重新啟動應用程式,並可產生遙測資料。

SearchForAllUpdatesAsync(String)

搜尋目前電腦或裝置上安裝的所有應用程式更新,並可選擇產生遙測資料。

SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions)

搜尋指定使用者目前電腦或裝置上安裝的所有應用程式更新,並可強制重啟應用程式,並可產生遙測資料。

SearchForAllUpdatesForUserAsync(User, String)

搜尋指定使用者目前電腦或裝置上所有可用的應用程式更新,並可選擇產生遙測資料。

SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions)

搜尋指定應用程式的更新,並允許強制重新啟動應用程式,並可產生遙測資料。

SearchForUpdatesAsync(String, String, String, String)

搜尋指定應用程式的更新,並可選擇產生遙測資料。

SearchForUpdatesAsync(String, String)

搜尋指定應用程式的更新。

SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions)

搜尋指定應用程式及使用者的更新,並可強制重新啟動應用程式,並可產生遙測資料。

SearchForUpdatesForUserAsync(User, String, String, String, String)

搜尋指定應用程式及使用者的更新,並可選擇產生遙測資料。

StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String)

備註

請注意,此 AppInstallManager.StartAppInstallAsync 方法已正式停用。 請參考 AppInstallManager 文件以獲取符合您需求的替代 API。

啟動安裝指定的應用程式,並可選擇產生遙測資料。

StartAppInstallAsync(String, String, Boolean, Boolean)

備註

請注意,此 AppInstallManager.StartAppInstallAsync 方法已正式停用。 請參考 AppInstallManager 文件以獲取符合您需求的替代 API。

啟動指定的應用程式安裝。

StartProductInstallAsync(String, String, String, String, AppInstallOptions)

啟動指定的應用程式或應用程式組合的安裝,並可指定額外安裝選項,例如是否允許強制重新啟動應用程式。

備註

在Windows開箱體驗(OOBE)期間,避免呼叫AppInstallManager.StartProductInstallAsync或AppInstallManager.StartProductInstallForUserAsync。

在 OOBE 完成前提出的安裝請求可能不會如預期,因為與 Store 相關的服務尚未完全初始化。

為了獲得最佳效果,請在首次使用者登入後先呼叫這些方法。

StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume)

開始安裝指定的應用程式或應用程式組合。

StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions)

啟動指定使用者的應用程式或應用程式套件安裝,並可指定額外安裝選項,例如是否允許強制重新啟動應用程式。

備註

在Windows開箱體驗(OOBE)期間,避免呼叫AppInstallManager.StartProductInstallAsync或AppInstallManager.StartProductInstallForUserAsync。

在 OOBE 完成前提出的安裝請求可能不會如預期,因為與 Store 相關的服務尚未完全初始化。

為了獲得最佳效果,請在首次使用者登入後先呼叫這些方法。

StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume)

開始安裝指定的應用程式或應用程式套件,針對指定使用者。

UpdateAppByPackageFamilyNameAsync(String, String)

啟動由套件家族名稱指定的應用程式更新,並可選擇產生遙測資料。

UpdateAppByPackageFamilyNameAsync(String)

啟動以套件族名指定的應用程式更新。

UpdateAppByPackageFamilyNameForUserAsync(User, String, String)

啟動由套件家族名稱指定的特定使用者的應用程式更新,並可選擇產生遙測資料。

事件

名稱 Description
ItemCompleted

當應用程式安裝完成時會發生。

ItemStatusChanged

當安裝佇列中的應用程式狀態改變時,會發生這種情況。

適用於