次の方法で共有


PackageManager.ProvisionPackageForAllUsersAsync メソッド

定義

オーバーロード

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。

options
PackageAllUserProvisioningOptions

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

戻り値

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

属性

Windows の要件

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

注釈

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

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

適用対象