PackageManager.ProvisionPackageForAllUsersAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
ProvisionPackageForAllUsersAsync(String) |
デバイス上のすべてのユーザーに対してアプリ パッケージ をインストールできるようにします。 |
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions) |
インストールする追加のオプション パッケージ を指定するオプションを含め、デバイス上のすべてのユーザーに対してアプリ パッケージをインストールできるようにします。 |
ProvisionPackageForAllUsersAsync(String)
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ ProvisionPackageForAllUsersAsync(Platform::String ^ packageFamilyName) = ProvisionPackageForAllUsersAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> ProvisionPackageForAllUsersAsync(winrt::hstring const& packageFamilyName);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> ProvisionPackageForAllUsersAsync(string packageFamilyName);
function provisionPackageForAllUsersAsync(packageFamilyName)
Public Function ProvisionPackageForAllUsersAsync (packageFamilyName As String) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)
パラメーター
- packageFamilyName
-
String
Platform::String
winrt::hstring
インストールするアプリ パッケージの FamilyName。
戻り値
アプリ パッケージのデプロイの進行状況と結果。
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 Fall Creators Update (10.0.16299.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v5.0 で導入)
|
例
この例では、デバイス上のすべてのユーザーに対してステージング済みパッケージまたは既存の登録済みパッケージを追加する方法を示します。
using Windows.Foundation;
using Windows.Management.Deployment;
public void provisionForAllUsers(string inputPackageFamilyName)
{
var packageManager = new PackageManager();
var result = packageManager.ProvisionPackageForAllUsersAsync(inputPackageFamilyName).AsTask().Result;
if (result.ExtendedErrorCode != null)
{
System.Console.WriteLine("Error {0} provisioning {1}", result, inputPackageFamilyName);
throw result.ExtendedErrorCode.HResult;
}
}
注釈
パッケージをプロビジョニングするには、管理者である必要があります。 プロビジョニングするアプリ パッケージはステージングする必要があり、システム ボリューム上に存在する必要があります。
パッケージが既にプロビジョニングされている場合は、"クリーン" 再プロビジョニングが実行されます。 "クリーン" 再プロビジョニングでは、このパッケージの以前のインストールがすべて削除されるため、パッケージは最初のインストールと同じように動作します。
Note
オプション パッケージをプロビジョニングする場合は、各オプション パッケージを独自のメソッド呼び出しで個別に指定する必要があります。 Windows ビルド 22000 以降では、 ProvisionPackageForAllUsersAsync のオーバーロードを使用して、1 回の呼び出しでインストールする追加のオプション パッケージを指定できます。
こちらもご覧ください
適用対象
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ ProvisionPackageForAllUsersAsync(Platform::String ^ mainPackageFamilyName, PackageAllUserProvisioningOptions ^ options) = ProvisionPackageForAllUsersAsync;
/// [Windows.Foundation.Metadata.Overload("ProvisionPackageForAllUsersWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> ProvisionPackageForAllUsersAsync(winrt::hstring const& mainPackageFamilyName, PackageAllUserProvisioningOptions const& options);
[Windows.Foundation.Metadata.Overload("ProvisionPackageForAllUsersWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> ProvisionPackageForAllUsersAsync(string mainPackageFamilyName, PackageAllUserProvisioningOptions options);
function provisionPackageForAllUsersAsync(mainPackageFamilyName, options)
Public Function ProvisionPackageForAllUsersAsync (mainPackageFamilyName As String, options As PackageAllUserProvisioningOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)
パラメーター
- mainPackageFamilyName
-
String
Platform::String
winrt::hstring
インストールするアプリ パッケージの FamilyName。
プロビジョニング オプション を指定する PackageAllUserProvisioningOptions オブジェクト。
戻り値
アプリ パッケージのデプロイの進行状況と結果。
- 属性
Windows の要件
デバイス ファミリ |
Windows 11 (10.0.22000.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v14.0 で導入)
|
注釈
パッケージをプロビジョニングするには、管理者である必要があります。 プロビジョニングするアプリ パッケージはステージングする必要があり、システム ボリューム上に存在する必要があります。
パッケージが既にプロビジョニングされている場合は、"クリーン" 再プロビジョニングが実行されます。 "クリーン" 再プロビジョニングでは、このパッケージの以前のインストールがすべて削除されるため、パッケージは最初のインストールと同じように動作します。