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 Build 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 引進)

備註

若要布建套件，您必須是系統管理員。 必須暫存要布建的應用程式套件，而且必須在系統磁片區上。

如果已布建套件，這會執行「清除」重新布建。 「清除」重新布建將會移除此套件的所有先前安裝，因此套件的行為會如同這是其第一次安裝一樣。