PackageManager.ProvisionPackageForAllUsersAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
ProvisionPackageForAllUsersAsync(String) |
Memungkinkan Paket aplikasi diinstal untuk semua pengguna di perangkat. |
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions) |
Memungkinkan Paket aplikasi diinstal untuk semua pengguna di perangkat, termasuk opsi untuk menentukan paket opsional tambahan yang akan diinstal. |
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)
Parameter
- packageFamilyName
-
String
Platform::String
winrt::hstring
FamilyName paket aplikasi yang akan diinstal.
Mengembalikan
Kemajuan dan hasil penyebaran paket aplikasi.
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)
|
Contoh
Contoh ini menunjukkan penambahan paket terdaftar yang ditahapkan atau sudah ada untuk semua pengguna di perangkat.
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;
}
}
Keterangan
Untuk menyediakan paket, Anda harus menjadi administrator. Paket aplikasi yang akan disediakan harus ditahapkan, dan harus pada volume sistem.
Jika paket sudah disediakan, ini melakukan provisi ulang "bersih". Provisi ulang "bersih" akan menghapus semua instalasi sebelumnya dari paket ini sehingga paket akan berulah seolah-olah ini adalah penginstalan pertamanya.
Catatan
Jika Anda menyediakan paket opsional, Anda harus menentukan setiap paket opsional satu per satu dengan panggilan metodenya sendiri. Dimulai dengan Windows Build 22000, Anda dapat menggunakan kelebihan beban ProvisionPackageForAllUsersAsync, untuk menentukan paket opsional tambahan untuk diinstal dengan satu panggilan.
Lihat juga
Berlaku untuk
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)
Parameter
- mainPackageFamilyName
-
String
Platform::String
winrt::hstring
FamilyName paket aplikasi yang akan diinstal.
Objek PackageAllUserProvisioningOptions yang menentukan opsi provisi.
Mengembalikan
Kemajuan dan hasil penyebaran paket aplikasi.
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 11 (diperkenalkan dalam 10.0.22000.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v14.0)
|
Keterangan
Untuk menyediakan paket, Anda harus menjadi administrator. Paket aplikasi yang akan disediakan harus ditahapkan, dan harus pada volume sistem.
Jika paket sudah disediakan, ini melakukan provisi ulang "bersih". Provisi ulang "bersih" akan menghapus semua instalasi sebelumnya dari paket ini sehingga paket akan berulah seolah-olah ini adalah penginstalan pertamanya.