PackageManager.ProvisionPackageForAllUsersAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Management.Deployment

オーバーロード

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。

戻り値

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

アプリ パッケージのデプロイの進行状況と結果。

属性
RemoteAsyncAttribute

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。

options
PackageAllUserProvisioningOptions

プロビジョニング オプション を指定する PackageAllUserProvisioningOptions オブジェクト。

戻り値

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

アプリ パッケージのデプロイの進行状況と結果。

属性
OverloadAttribute RemoteAsyncAttribute

Windows の要件

デバイス ファミリ
Windows 11 (10.0.22000.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v14.0 で導入)

注釈

パッケージをプロビジョニングするには、管理者である必要があります。 プロビジョニングするアプリ パッケージはステージングする必要があり、システム ボリューム上に存在する必要があります。

パッケージが既にプロビジョニングされている場合は、"クリーン" 再プロビジョニングが実行されます。 "クリーン" 再プロビジョニングでは、このパッケージの以前のインストールがすべて削除されるため、パッケージは最初のインストールと同じように動作します。

適用対象