PackageManager.ProvisionPackageForAllUsersAsync Méthode

Définition

Espace de noms:

Windows.Management.Deployment

Surcharges

ProvisionPackageForAllUsersAsync(String)	Permet d’installer un package d’application pour tous les utilisateurs sur un appareil.
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)	Permet d’installer un package d’application pour tous les utilisateurs sur un appareil, y compris les options permettant de spécifier des packages facultatifs supplémentaires à installer.

ProvisionPackageForAllUsersAsync(String)

Permet d’installer un package d’application pour tous les utilisateurs sur un appareil.

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)

Paramètres

packageFamilyName

String

Platform::String

winrt::hstring

FamilyName du package d’application à installer.

Retours

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Progression et résultat du déploiement du package d’application.

Attributs

RemoteAsyncAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Exemples

Cet exemple illustre l’ajout d’un package enregistré intermédiaire ou existant pour tous les utilisateurs sur un appareil.

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;
    }
}

Remarques

Pour approvisionner un package, vous devez être administrateur. Le package d’application à approvisionner doit être intermédiaire et il doit se trouver sur le volume système.

Si le package est déjà provisionné, cela effectue un réapprovisionnement « propre ». Un reprovision « propre » supprime toutes les installations précédentes de ce package afin que le package se comporte comme s’il s’agissait de sa première installation.

Notes

Si vous approvisionnez des packages facultatifs, vous devez spécifier chaque package facultatif individuellement avec son propre appel de méthode. À compter de Windows Build 22000, vous pouvez utiliser la surcharge de ProvisionPackageForAllUsersAsync pour spécifier des packages facultatifs supplémentaires à installer avec un seul appel.

Voir aussi

• Package

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Permet d’installer un package d’application pour tous les utilisateurs sur un appareil, y compris les options permettant de spécifier des packages facultatifs supplémentaires à installer.

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)

Paramètres

mainPackageFamilyName

String

Platform::String

winrt::hstring

FamilyName du package d’application à installer.

options

PackageAllUserProvisioningOptions

Objet PackageAllUserProvisioningOptions spécifiant les options d’approvisionnement.

Retours

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Progression et résultat du déploiement du package d’application.

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 11 (introduit dans 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v14.0)

Remarques

Pour approvisionner un package, vous devez être administrateur. Le package d’application à approvisionner doit être intermédiaire et il doit se trouver sur le volume système.

Si le package est déjà provisionné, cela effectue un réapprovisionnement « propre ». Un reprovision « propre » supprime toutes les installations précédentes de ce package afin que le package se comporte comme s’il s’agissait de sa première installation.