Поделиться через


PackageManager.ProvisionPackageForAllUsersAsync Метод

Определение

Перегрузки

ProvisionPackageForAllUsersAsync(String)

Позволяет установить пакет приложения для всех пользователей на устройстве.

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Позволяет установить пакет приложения для всех пользователей на устройстве, включая параметры для указания дополнительных дополнительных пакетов для установки.

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)

Параметры

packageFamilyName
String

Platform::String

winrt::hstring

FamilyName устанавливаемого пакета приложения.

Возвращаемое значение

Ход выполнения и результат развертывания пакета приложения.

Атрибуты

Требования к Windows

Семейство устройств
Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v5.0)

Примеры

В этом примере показано добавление промежуточного или существующего зарегистрированного пакета для всех пользователей на устройстве.

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

Комментарии

Для подготовки пакета необходимо быть администратором. Подготовленный пакет приложения должен быть промежуточным и находиться на системном томе.

Если пакет уже подготовлен, выполняется "чистая" повторная подготовка. При "чистой" повторной подготовке будут удалены все предыдущие установки этого пакета, поэтому пакет будет вести себя так, как если бы это была его первая установка.

Примечание

При подготовке необязательных пакетов необходимо указать каждый необязательный пакет по отдельности с помощью собственного вызова метода. Начиная со сборки Windows 22000, можно использовать перегрузку ProvisionPackageForAllUsersAsync, чтобы указать дополнительные необязательные пакеты для установки с одним вызовом.

См. также раздел

Применяется к

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)

Параметры

mainPackageFamilyName
String

Platform::String

winrt::hstring

FamilyName устанавливаемого пакета приложения.

options
PackageAllUserProvisioningOptions

Объект PackageAllUserProvisioningOptions , указывающий параметры подготовки.

Возвращаемое значение

Ход выполнения и результат развертывания пакета приложения.

Атрибуты

Требования к Windows

Семейство устройств
Windows 11 (появилось в 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v14.0)

Комментарии

Для подготовки пакета необходимо быть администратором. Подготовленный пакет приложения должен быть промежуточным и находиться на системном томе.

Если пакет уже подготовлен, выполняется "чистая" повторная подготовка. При "чистой" повторной подготовке будут удалены все предыдущие установки этого пакета, поэтому пакет будет вести себя так, как если бы это была его первая установка.

Применяется к