PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) 메서드

정의

네임스페이스:

Windows.Management.Deployment

지정된 배포 옵션을 사용하여 현재 사용자에 대한 패키지 (기본 패키지) 및 추가 종속성 패키지를 추가합니다.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ AddPackageByUriAsync(Uri ^ packageUri, AddPackageOptions ^ options) = AddPackageByUriAsync;

/// [Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> AddPackageByUriAsync(Uri const& packageUri, AddPackageOptions const& options);

[Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> AddPackageByUriAsync(System.Uri packageUri, AddPackageOptions options);

function addPackageByUriAsync(packageUri, options)

Public Function AddPackageByUriAsync (packageUri As Uri, options As AddPackageOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

매개 변수

packageUri

Uri Uri

추가할 패키지의 URI입니다. URI는 로컬 파일 경로 및 로컬 네트워크 경로에 파일 URI 스키마(file://)를 사용할 수 있습니다. HTTP 및 HTTPS 프로토콜도 지원됩니다. Windows 빌드 22556부터 URI는 패키지 또는 앱 설치 관리자 파일을 가리킬 수 있습니다.

options

AddPackageOptions

작업에 대한 패키지 배포 옵션입니다.

반환

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

배포 요청의 상태입니다. DeploymentResult에는 완료된 배포 작업의 최종 반환 값이 포함됩니다. DeploymentProgress를 사용하여 배포 작업의 전체 과정에서 완료 비율을 얻을 수 있습니다.

특성

OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 2004 (10.0.19041.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v10.0에서 도입되었습니다.)

설명

이 메서드는 모든 배포 옵션을 단일 매개 변수로 통합하여 기존 AddPackageAsync 오버로드를 간소화합니다. 이 메서드는 AddPackageAsync 오버로드에서 사용할 수 없는 다음 기능도 지원합니다.

• options 매개 변수의 ExternalLocationURI 속성을 사용하여 패키지 매니페스트가 애플리케이션 콘텐츠를 참조할 수 있는 MSIX 패키지 외부에서 외부 디스크 위치의 URI를 지정할 수 있습니다. 이 시나리오 및 관련 코드 샘플에 대한 자세한 내용은 외부 위치로 패키징하여 패키지 ID 부여를 참조하세요.

• options 매개 변수의 AllowUnsigned 속성을 사용하여 서명되지 않은 패키지의 실행 파일에서 활성화 정보를 허용할 수 있습니다. 이 시나리오 및 관련 코드 샘플에 대한 자세한 내용은 호스트된 앱을 참조하세요.

추가 정보

• AddPackageOptions
• 패키지
• 외부 위치로 패키지하여 패키지 ID 부여
• 호스트된 앱