Partager via

PackageManager.ProvisionPackageForAllUsersAsync Méthode

  • Référence

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)

Modifier

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

S’applique à

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Modifier

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.

S’applique à