PackageManager.ProvisionPackageForAllUsersAsync 方法

定义

命名空间:

Windows.Management.Deployment

重载

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。

返回

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

应用包部署的进度和结果。

属性

RemoteAsyncAttribute

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 对象。

返回

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

应用包部署的进度和结果。

属性

OverloadAttribute RemoteAsyncAttribute

Windows 要求

设备系列	Windows 11 (在 10.0.22000.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v14.0 中引入)

注解

若要预配包，你必须是管理员。 要预配的应用包必须暂存，并且它必须位于系统卷上。

如果已预配包，则会执行“清理”重新预配。 “干净”的重新预配将删除此包的所有以前安装，使包的行为就像这是其第一次安装一样。