AppInstallManager クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
プログラムによってアプリをインストールするためのメンバーを提供します。これには、アプリのインストールを開始し、現在進行中のアプリのインストールの一覧を取得する機能が含まれます。
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 AppInstallManagerfunction AppInstallManager()Public NotInheritable Class AppInstallManager- 継承
- 属性
Windows の要件
| 要件 | 説明 |
|---|---|
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
| アプリの機能 |
runFullTrust
|
注釈
Important
この API へのアクセスは、Microsoftによって開発されたアプリに限定されたプライベート機能によって保護されます。
注
Windows Out of Box Experience (OOBE) の間は、AppInstallManager.StartProductInstallAsync または AppInstallManager.StartProductInstallForUserAsync を呼び出さないようにします。
OOBE が完了する前に行われたインストール要求は、ストア関連のサービスがまだ完全に初期化されていない可能性があるため、期待どおりに動作しない可能性があります。
最適な結果を得るには、最初のユーザー サインイン後にこれらのメソッドを呼び出します。
バージョン履歴
| Windows バージョン | SDK バージョン | 値の追加 |
|---|---|---|
| 1511 | 10586 | Cancel(String,String) |
| 1511 | 10586 | GetIsAppAllowedToInstallAsync(String,String,String,String) |
| 1511 | 10586 | Pause(String,String) |
| 1511 | 10586 | Restart(String,String) |
| 1511 | 10586 | SearchForAllUpdatesAsync(String) |
| 1511 | 10586 | SearchForUpdatesAsync(String,String,String,String) |
| 1511 | 10586 | StartAppInstallAsync(String,String,Boolean,Boolean,String,String,String) |
| 1511 | 10586 | UpdateAppByPackageFamilyNameAsync(String,String) |
| 1607 | 14393 | GetIsAppAllowedToInstallForUserAsync |
| 1607 | 14393 | GetIsApplicableForUserAsync |
| 1607 | 14393 | MoveToFrontOfDownloadQueue |
| 1607 | 14393 | SearchForAllUpdatesForUserAsync(User,String) |
| 1607 | 14393 | SearchForUpdatesForUserAsync(User,String,String,String,String) |
| 1607 | 14393 | StartProductInstallAsync(String,String,String,String,Boolean,String,PackageVolume) |
| 1607 | 14393 | StartProductInstallForUserAsync(User,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 | SearchForAllUpdatesForUserAsync(User,String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesAsync(String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesForUserAsync(User,String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | StartProductInstallAsync(String,String,String,String,AppInstallOptions) |
| 1803 | 17134 | StartProductInstallForUserAsync(User,String,String,String,String,AppInstallOptions) |
| 1809 | 17763 | CanInstallForAllUsers |
コンストラクター
| 名前 | 説明 |
|---|---|
| AppInstallManager() |
AppInstallManager クラスの新しいインスタンスを作成して初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AcquisitionIdentity |
アプリのインストールに関連付けられているユーザー ID を取得または設定します。 |
| AppInstallItems |
現在インストール キュー内にあるすべてのアプリに関する情報を取得します。 |
| AppInstallItemsWithGroupSupport |
現在インストール キューにある 1 つのアプリ バンドルの一部であるすべてのアプリに関する情報を取得します。 |
| AutoUpdateSetting |
現在のコンピューターまたはデバイス上のアプリの自動更新設定を取得または設定します。 |
| CanInstallForAllUsers |
呼び出し元アプリに管理者特権があるかどうかを示す値を取得または設定します。これにより、すべてのユーザーのアプリのインストールが成功します。 |
メソッド
| 名前 | 説明 |
|---|---|
| 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) |
指定した ID 情報を持つパッケージを現在のデバイスにインストールできるかどうかを示す値を返します。 |
| GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String) |
指定した ID 情報を持つパッケージを、指定したユーザーの現在のデバイスにインストールできるかどうかを示す値を返します。 |
| 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) |
注
テレメトリ データを生成するオプションを使用して、指定したアプリのインストールを開始します。 |
| StartAppInstallAsync(String, String, Boolean, Boolean) |
注
指定したアプリのインストールを開始します。 |
| StartProductInstallAsync(String, String, String, String, AppInstallOptions) |
アプリの強制再起動を許可するかどうかなど、追加のインストール オプションを指定する機能を使用して、指定したアプリまたはアプリ バンドルのインストールを開始します。 注 Windows Out of Box Experience (OOBE) の間は、 OOBE が完了する前に行われたインストール要求は、ストア関連のサービスがまだ完全に初期化されていない可能性があるため、期待どおりに動作しない可能性があります。 最適な結果を得るには、最初のユーザー サインイン後にこれらのメソッドを呼び出します。 |
| StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume) |
指定したアプリまたはアプリ バンドルのインストールを開始します。 |
| StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions) |
アプリの強制再起動を許可するかどうかなど、追加のインストール オプションを指定する機能を使用して、指定したユーザーの指定したアプリまたはアプリ バンドルのインストールを開始します。 注 Windows Out of Box Experience (OOBE) の間は、 OOBE が完了する前に行われたインストール要求は、ストア関連のサービスがまだ完全に初期化されていない可能性があるため、期待どおりに動作しない可能性があります。 最適な結果を得るには、最初のユーザー サインイン後にこれらのメソッドを呼び出します。 |
| StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume) |
指定したユーザーの指定したアプリまたはアプリ バンドルのインストールを開始します。 |
| UpdateAppByPackageFamilyNameAsync(String, String) |
テレメトリ データを生成するオプションを使用して、パッケージ ファミリ名で指定されたアプリの更新を開始します。 |
| UpdateAppByPackageFamilyNameAsync(String) |
パッケージ ファミリ名で指定されたアプリの更新を開始します。 |
| UpdateAppByPackageFamilyNameForUserAsync(User, String, String) |
テレメトリ データを生成するオプションを使用して、パッケージ ファミリ名で指定された特定のユーザーのアプリの更新を開始します。 |
イベント
| 名前 | 説明 |
|---|---|
| ItemCompleted |
アプリのインストールが完了したときに発生します。 |
| ItemStatusChanged |
インストール キュー内のアプリの状態が変更されたときに発生します。 |