Compartilhar via


PackageManager.ProvisionPackageForAllUsersAsync Método

Definição

Sobrecargas

ProvisionPackageForAllUsersAsync(String)

Permite que um pacote de aplicativos seja instalado para todos os usuários em um dispositivo.

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Permite que um pacote de aplicativos seja instalado para todos os usuários em um dispositivo, incluindo opções para especificar pacotes opcionais adicionais a serem instalados.

ProvisionPackageForAllUsersAsync(String)

Permite que um pacote de aplicativos seja instalado para todos os usuários em um 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)

Parâmetros

packageFamilyName
String

Platform::String

winrt::hstring

O FamilyName do pacote do aplicativo a ser instalado.

Retornos

O progresso e o resultado da implantação do pacote de aplicativos.

Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Exemplos

Este exemplo demonstra a adição de um pacote registrado em etapas ou existente para todos os usuários em um 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;
    }
}

Comentários

Para provisionar um pacote, você deve ser um administrador. O pacote do aplicativo a ser provisionado deve ser preparado e deve estar no volume do sistema.

Se o pacote já estiver provisionado, isso executará um reprovisionamento "limpo". Um reprovisionamento "limpo" removerá todas as instalações anteriores desse pacote para que o pacote se comporte como se esta fosse sua primeira instalação.

Observação

Se você estiver provisionando pacotes opcionais, deverá especificar cada pacote opcional individualmente com sua própria chamada de método. A partir do Windows Build 22000, você pode usar a sobrecarga de ProvisionPackageForAllUsersAsync, para especificar pacotes opcionais adicionais para instalação com uma única chamada.

Confira também

Aplica-se a

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Permite que um pacote de aplicativos seja instalado para todos os usuários em um dispositivo, incluindo opções para especificar pacotes opcionais adicionais a serem instalados.

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)

Parâmetros

mainPackageFamilyName
String

Platform::String

winrt::hstring

O FamilyName do pacote do aplicativo a ser instalado.

options
PackageAllUserProvisioningOptions

Um objeto PackageAllUserProvisioningOptions que especifica as opções de provisionamento.

Retornos

O progresso e o resultado da implantação do pacote de aplicativos.

Atributos

Requisitos do Windows

Família de dispositivos
Windows 11 (introduzida na 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v14.0)

Comentários

Para provisionar um pacote, você deve ser um administrador. O pacote do aplicativo a ser provisionado deve ser preparado e deve estar no volume do sistema.

Se o pacote já estiver provisionado, isso executará um reprovisionamento "limpo". Um reprovisionamento "limpo" removerá todas as instalações anteriores desse pacote para que o pacote se comporte como se esta fosse sua primeira instalação.

Aplica-se a