PackageManager.ProvisionPackageForAllUsersAsync Methode

Definition

Namespace:

Windows.Management.Deployment

Überlädt

ProvisionPackageForAllUsersAsync(String)	Ermöglicht die Installation eines App-Pakets für alle Benutzer auf einem Gerät.
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)	Ermöglicht die Installation eines App-Pakets für alle Benutzer auf einem Gerät, einschließlich Optionen zum Angeben zusätzlicher optionaler Pakete, die installiert werden sollen.

ProvisionPackageForAllUsersAsync(String)

Ermöglicht die Installation eines App-Pakets für alle Benutzer auf einem Gerät.

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)

Parameter

packageFamilyName

String

Platform::String

winrt::hstring

Der FamilyName des zu installierenden App-Pakets.

Gibt zurück

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Der Fortschritt und das Ergebnis der Bereitstellung des App-Pakets.

Attribute

RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Beispiele

In diesem Beispiel wird das Hinzufügen eines mehrstufigen oder vorhandenen registrierten Pakets für alle Benutzer auf einem Gerät veranschaulicht.

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

Hinweise

Um ein Paket bereitzustellen, müssen Sie Administrator sein. Das bereitzustellende App-Paket muss bereitgestellt werden, und es muss sich auf dem Systemvolume befinden.

Wenn das Paket bereits bereitgestellt wurde, führt dies eine "sauber"-Erneute Bereitstellung durch. Bei einer "sauber"-Neubereitstellung werden alle vorherigen Installationen dieses Pakets entfernt, sodass sich das Paket so verhält, als wäre dies seine erste Installation.

Hinweis

Wenn Sie optionale Pakete bereitstellen, müssen Sie jedes optionale Paket einzeln mit einem eigenen Methodenaufruf angeben. Ab Windows Build 22000 können Sie die Überladung von ProvisionPackageForAllUsersAsync verwenden, um zusätzliche optionale Pakete anzugeben, die mit einem einzigen Aufruf installiert werden sollen.

Weitere Informationen

• Pakete

ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)

Ermöglicht die Installation eines App-Pakets für alle Benutzer auf einem Gerät, einschließlich Optionen zum Angeben zusätzlicher optionaler Pakete, die installiert werden sollen.

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)

Parameter

mainPackageFamilyName

String

Platform::String

winrt::hstring

Der FamilyName des zu installierenden App-Pakets.

options

PackageAllUserProvisioningOptions

Ein PackageAllUserProvisioningOptions-Objekt , das die Bereitstellungsoptionen angibt.

Gibt zurück

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Der Fortschritt und das Ergebnis der Bereitstellung des App-Pakets.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie	Windows 11 (eingeführt in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v14.0)

Hinweise

Um ein Paket bereitzustellen, müssen Sie Administrator sein. Das bereitzustellende App-Paket muss bereitgestellt werden, und es muss sich auf dem Systemvolume befinden.

Wenn das Paket bereits bereitgestellt wurde, führt dies eine "sauber"-Erneute Bereitstellung durch. Bei einer "sauber"-Neubereitstellung werden alle vorherigen Installationen dieses Pakets entfernt, sodass sich das Paket so verhält, als wäre dies seine erste Installation.