Freigeben über


PackageManager.ProvisionPackageForAllUsersAsync Methode

Definition

Ü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

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

Attribute

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

Gilt für:

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

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

Attribute

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.

Gilt für: