PackageManager.ProvisionPackageForAllUsersAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
ProvisionPackageForAllUsersAsync(String) |
Permite instalar un paquete de aplicación para todos los usuarios de un dispositivo. |
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions) |
Permite instalar un paquete de aplicación para todos los usuarios de un dispositivo, incluidas las opciones para especificar paquetes opcionales adicionales que se van a instalar. |
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)
Parámetros
- packageFamilyName
-
String
Platform::String
winrt::hstring
FamilyName del paquete de la aplicación que se va a instalar.
Devoluciones
El progreso y el resultado de la implementación del paquete de la aplicación.
- Atributos
Requisitos de Windows
Familia de dispositivos |
Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)
|
Ejemplos
En este ejemplo se muestra cómo agregar un paquete almacenado provisional o existente registrado para todos los usuarios de 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;
}
}
Comentarios
Para aprovisionar un paquete, debe ser administrador. El paquete de aplicación que se va a aprovisionar debe almacenar provisionalmente y debe estar en el volumen del sistema.
Si el paquete ya está aprovisionado, realiza un reaprovisionamiento "limpio". Un reaprovisionamiento "limpio" quitará todas las instalaciones anteriores de este paquete para que el paquete se comporte como si fuera su primera instalación.
Nota
Si va a aprovisionar paquetes opcionales, debe especificar cada paquete opcional individualmente con su propia llamada de método. A partir de La compilación 22000 de Windows, puedes usar la sobrecarga de ProvisionPackageForAllUsersAsync para especificar paquetes opcionales adicionales para instalar con una sola llamada.
Consulte también
Se aplica a
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)
Parámetros
- mainPackageFamilyName
-
String
Platform::String
winrt::hstring
FamilyName del paquete de la aplicación que se va a instalar.
Objeto PackageAllUserProvisioningOptions que especifica las opciones de aprovisionamiento.
Devoluciones
El progreso y el resultado de la implementación del paquete de la aplicación.
- Atributos
Requisitos de Windows
Familia de dispositivos |
Windows 11 (se introdujo en la versión 10.0.22000.0)
|
API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v14.0)
|
Comentarios
Para aprovisionar un paquete, debe ser administrador. El paquete de aplicación que se va a aprovisionar debe almacenar provisionalmente y debe estar en el volumen del sistema.
Si el paquete ya está aprovisionado, realiza un reaprovisionamiento "limpio". Un reaprovisionamiento "limpio" quitará todas las instalaciones anteriores de este paquete para que el paquete se comporte como si fuera su primera instalación.