PackageManager.ProvisionPackageForAllUsersAsync Metodo

Definizione

Spazio dei nomi:

Windows.Management.Deployment

Overload

ProvisionPackageForAllUsersAsync(String)	Abilita l'installazione di un pacchetto dell'app per tutti gli utenti in un dispositivo.
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)	Abilita l'installazione di un pacchetto dell'app per tutti gli utenti in un dispositivo, incluse le opzioni per specificare pacchetti facoltativi aggiuntivi da installare.

ProvisionPackageForAllUsersAsync(String)

Abilita l'installazione di un pacchetto dell'app per tutti gli utenti in un dispositivo.

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)

Parametri

packageFamilyName

String

Platform::String

winrt::hstring

Nome famiglia del pacchetto dell'app da installare.

Restituisce

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Lo stato di avanzamento e il risultato della distribuzione del pacchetto dell'app.

Attributi

RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Esempio

In questo esempio viene illustrato l'aggiunta di un pacchetto registrato in fasi o esistente per tutti gli utenti in un dispositivo.

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

Commenti

Per effettuare il provisioning di un pacchetto, è necessario essere un amministratore. Il pacchetto dell'app da effettuare deve essere eseguito in fase e deve trovarsi nel volume di sistema.

Se il pacchetto è già stato effettuato il provisioning, questa operazione esegue un reprovisioning "clean". Un reprovisioning "pulito" rimuoverà tutte le installazioni precedenti di questo pacchetto in modo che il pacchetto si comporta come se fosse la prima installazione.

Nota

Se si esegue il provisioning di pacchetti facoltativi, è necessario specificare ogni pacchetto facoltativo singolarmente con la propria chiamata al metodo. A partire da Windows Build 22000, è possibile usare l'overload di ProvisionPackageForAllUsersAsync per specificare pacchetti facoltativi aggiuntivi da installare con una singola chiamata.

Vedi anche

• Pacchetto

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Abilita l'installazione di un pacchetto dell'app per tutti gli utenti in un dispositivo, incluse le opzioni per specificare pacchetti facoltativi aggiuntivi da installare.

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)

Parametri

mainPackageFamilyName

String

Platform::String

winrt::hstring

Nome famiglia del pacchetto dell'app da installare.

options

PackageAllUserProvisioningOptions

Oggetto PackageAllUserProvisioningOptions che specifica le opzioni di provisioning.

Restituisce

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Lo stato di avanzamento e il risultato della distribuzione del pacchetto dell'app.

Attributi

OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 11 (è stato introdotto in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v14.0)

Commenti

Per effettuare il provisioning di un pacchetto, è necessario essere un amministratore. Il pacchetto dell'app da effettuare deve essere eseguito in fase e deve trovarsi nel volume di sistema.

Se il pacchetto è già stato effettuato il provisioning, questa operazione esegue un reprovisioning "clean". Un reprovisioning "pulito" rimuoverà tutte le installazioni precedenti di questo pacchetto in modo che il pacchetto si comporta come se fosse la prima installazione.