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의 오버로드를 사용하여 단일 호출로 설치할 추가 선택적 패키지를 지정할 수 있습니다.

추가 정보

• Package

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에서 도입되었습니다.)

설명

패키지를 프로비전하려면 관리자여야 합니다. 프로비전할 앱 패키지는 스테이징되어야 하며 시스템 볼륨에 있어야 합니다.

패키지가 이미 프로비전된 경우 "클린" 다시 프로비전을 수행합니다. "클린" 다시 프로비전은 이 패키지의 이전 설치를 모두 제거하므로 패키지가 첫 번째 설치인 것처럼 작동합니다.