EnterpriseModernAppManagement CSP

아래 표에서는 Windows의 적용 가능성을 보여 줍니다.

버전 Windows 10 Windows 11
Home
Pro
Windows SE 아니요
Business
Enterprise
Education

EnterpriseModernAppManagement CSP(구성 서비스 공급자)는 최신 엔터프라이즈 앱의 프로비전 및 보고에 사용됩니다. 이 CSP를 사용하여 앱 인벤토리를 보고하고, 사용자를 위한 앱을 설치 및 제거하고, 디바이스에 앱을 프로비전하고, 앱 라이선스를 관리하는 방법에 대한 자세한 내용은 엔터프라이즈 앱 관리를 참조하세요.

참고

Windows Holographic은 EnterpriseModernAppManagement CSP의 사용자별 구성만 지원합니다.

다음 예제에서는 트리 형식의 EnterpriseModernAppManagement 구성 서비스 공급자를 보여 있습니다.

./Vendor/MSFT
EnterpriseModernAppManagement
----AppManagement
--------EnterpriseID
------------PackageFamilyName
----------------PackageFullName
--------------------Name
--------------------Version
--------------------Publisher
--------------------Architecture
--------------------InstallLocation
--------------------IsFramework
--------------------IsBundle
--------------------InstallDate
--------------------ResourceID
--------------------PackageStatus
--------------------RequiresReinstall
--------------------Users
--------------------IsProvisioned
----------------DoNotUpdate
----------------AppSettingPolicy
--------------------SettingValue
--------UpdateScan
--------LastScanError
--------AppInventoryResults
--------AppInventoryQuery
----AppInstallation
--------PackageFamilyName
------------StoreInstall
------------HostedInstall
------------LastError
------------LastErrorDesc
------------Status
------------ProgressStatus
----AppLicenses
--------StoreLicenses
------------LicenseID
----------------LicenseCategory
----------------LicenseUsage
----------------RequesterID
----------------AddLicense
----------------GetLicenseFromStore

디바이스 또는 사용자 컨텍스트 사용자 컨텍스트의 경우 ./User/Vendor/MSFT 경로를 사용하고 디바이스 컨텍스트의 경우 ./Device/Vendor/MSFT 경로를 사용합니다.

참고

Windows Holographic은 EnterpriseModernAppManagement CSP의 사용자별 구성만 지원합니다.

AppManagement 필수. 인벤토리 및 앱 관리(설치 후)에 사용됩니다.

AppManagement/UpdateScan 필수. Windows 업데이트 검사를 시작하는 데 사용됩니다.

지원되는 작업은 Execute입니다.

AppManagement/LastScanError 필수. 업데이트 검사에서 반환된 마지막 오류 코드를 보고합니다.

지원되는 작업은 Get입니다.

AppManagement/AppInventoryResults Windows 10 버전 1511에 추가되었습니다. 필수. AppInventoryQuery 작업 후에 만든 앱 인벤토리에 대한 결과를 반환합니다.

지원되는 작업은 Get입니다.

다음은 AppInventoryResults 작업의 예입니다.

<Get>
   <CmdID>11</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryResults</LocURI>
      </Target>
   </Item>
</Get>

AppManagement/AppInventoryQuery Windows 10 버전 1511에 추가되었습니다. 필수. 앱 인벤토리에 대한 쿼리를 지정합니다.

쿼리 매개 변수:

  • 출력 - AppInventoryResults 작업에서 반환된 정보에 대한 매개 변수를 지정합니다. 여러 값은 | 구분해야 합니다. 유효한 값은 다음과 같습니다.

    • PackagesName - 앱의 PackageFamilyNamePackageFullName 을 반환합니다. 아무것도 지정되지 않은 경우 기본값입니다.
    • PackageDetails - 패키지의 모든 인벤토리 특성을 반환합니다. 이 정보에는 PackageNames 매개 변수의 모든 정보가 포함되지만 RequiresReinstall의 유효성은 검사하지 않습니다.
    • RequiredReinstall - 인벤토리 쿼리에서 앱의 앱 상태의 유효성을 검사하여 다시 설치가 필요한지 확인합니다. 이 특성은 설치된 앱 수에 따라 시스템 성능에 영향을 미칠 수 있습니다. 리소스 패키지가 업데이트되거나 앱이 변조된 상태일 때 다시 설치가 요구됩니다.
  • 원본 - 기존 인벤토리 노드에 맞는 앱 분류를 지정합니다. 특정 필터를 사용하거나 필터를 지정하지 않으면 모든 원본이 반환됩니다. 값을 지정하지 않으면 모든 분류가 반환됩니다. 유효한 값은 다음과 같습니다.

    • AppStore - 이 분류는 Microsoft Store에서 획득한 앱에 대한 것입니다. 이러한 앱은 Microsoft Store 또는 비즈니스용 Microsoft Store 엔터프라이즈 앱에서 직접 설치되었습니다.
    • nonStore - 이 분류는 Microsoft Store에서 가져오지 않은 앱에 대한 것입니다.
    • 시스템 - OS의 일부인 앱입니다. 이러한 앱은 제거할 수 없습니다. 이 분류는 읽기 전용이며 인벤토리에만 사용할 수 있습니다.
  • PackageTypeFilter - 사용자 또는 디바이스를 쿼리하는 데 사용할 수 있는 하나 이상의 패키지 유형을 지정합니다. 여러 값을 | 구분해야 합니다. 유효한 값은 다음과 같습니다.

    • Main - 기본 설치된 패키지를 반환합니다.
    • 번들 - 설치된 번들 패키지를 반환합니다.
    • Framework - 설치된 프레임워크 패키지를 반환합니다.
    • 리소스 - 설치된 리소스 패키지를 반환합니다. 리소스는 언어, 크기 조정 또는 DirectX 리소스입니다. 그들은 번들의 부분입니다.
    • XAP - XAP 패키지 형식을 반환합니다. 이 필터는 Windows Mobile에서만 지원됩니다.
    • All - 모든 패키지 형식을 반환합니다.

    값을 지정하지 않으면 Main, Bundle 및 Framework의 조합이 반환됩니다.

  • PackageFamilyName - 특정 패키지의 이름을 지정합니다. 이 매개 변수를 지정하면 패키지에 이 값이 포함된 경우 패키지 패밀리 이름이 반환됩니다.

    이 값을 지정하지 않으면 모든 패키지가 반환됩니다.

  • Publisher - 특정 패키지의 게시자를 지정합니다. 이 매개 변수를 지정하면 게시자 필드에 값이 있으면 게시자를 반환합니다.

    이 값을 지정하지 않으면 모든 게시자가 반환됩니다.

지원되는 작업은 가져오기 및 바꾸기입니다.

다음 예제에서는 패키지 이름에 대한 인벤토리 쿼리를 설정하고 비스토어 앱인 모든 기본 패키지에 대한 다시 설치 상태를 확인합니다.

<Replace>
   <CmdID>10</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryQuery</LocURI>
      </Target>
      <Meta><Format xmlns="syncml:metinf">xml</Format></Meta>
      <Data><Inventory Output="PackageNames|RequiresReinstall" Source="nonStore" PackageTypeFilter="Main" /></Data>
   </Item>
</Replace>

AppManagement/RemovePackage Windows 10 버전 1703에 추가되었습니다. 패키지를 제거하는 데 사용됩니다. ./User/Vendor/MSFT에 대해 지원되지 않습니다.

매개 변수:

  • 패키지
    • 이름: 제거할 특정 패키지의 PackageFullName을 지정합니다.
    • RemoveForAllUsers:
      • 0(기본값) – 새 사용자가 패키지를 받지 않도록 패키지가 프로비전되지 않습니다. 패키지는 현재 사용자에 대해 설치된 상태로 유지됩니다. 이 옵션은 현재 지원되지 않습니다.
      • 1 – 프로비전된 패키지인 경우에만 모든 사용자에 대해 패키지가 제거됩니다.
  • 사용자(선택 사항): 패키지를 제거할 특정 사용자의 SID를 지정합니다. 지정된 사용자에 대한 패키지만 제거할 수 있습니다.

지원되는 작업은 Execute입니다.

다음 예제에서는 모든 사용자에 대한 패키지를 제거합니다.

<Exec>
   <CmdID>10</CmdID>
   <Item>
      <Target>
         <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/RemovePackage</LocURI>
      </Target>
      <Meta><Format xmlns="syncml:metinf">xml</Format></Meta>
      <Data>
          <Package Name="{PackageFullName}" RemoveForAllUsers="1" />
      </Data>
   </Item>
</Exec>

AppManagement/nonStore Microsoft Store에서 획득하지 않은 엔터프라이즈 앱 또는 개발자 앱을 관리하는 데 사용됩니다.

지원되는 작업은 Get입니다.

AppManagement/System 운영 체제의 일부로 설치된 앱을 보고합니다.

지원되는 작업은 Get입니다.

AppManagement/AppStore 필수. Microsoft 스토어에서 앱을 관리하는 데 사용됩니다.

지원되는 작업은 가져오기 및 삭제입니다.

AppManagement/AppStore/ReleaseManagement Windows 10, 버전 1809 추가되었습니다. Microsoft 스토어를 통한 업데이트 관리를 위한 내부 노드입니다. 이러한 설정을 통해 IT 관리자는 사용자가 업데이트를 받는 데 사용할 앱의 업데이트 채널을 지정할 수 있습니다. IT 관리자는 조직의 나머지 부분에 대규모 배포 전에 테스트를 위해 더 작은 그룹에 특정 릴리스를 할당할 수 있습니다.

참고

ReleaseManagement 설정은 Microsoft 스토어를 통한 업데이트에만 적용됩니다.

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey Windows 10, 버전 1809 추가되었습니다. 앱 또는 앱 집합의 식별자입니다. 앱이 하나만 있는 경우 PackageFamilyName입니다. 앱 집합의 경우 기본 앱의 PackageFamilyName입니다.

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/ChannelId Windows 10, 버전 1809 추가되었습니다. 앱 채널 ID를 지정합니다.

값 유형은 문자열입니다.

지원되는 작업은 추가, 가져오기, 바꾸기 및 삭제입니다.

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/ReleaseManagementId Windows 10, 버전 1809 추가되었습니다. IT 관리자는 릴리스 ID를 지정하여 사용자 또는 디바이스가 켜지도록 하려는 특정 릴리스를 나타낼 수 있습니다.

값 유형은 문자열입니다.

지원되는 작업은 추가, 가져오기, 바꾸기 및 삭제입니다.

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/EffectiveRelease Windows 10, 버전 1809 추가되었습니다. 디바이스에서 여러 사용자 정책을 설정할 때 사용할 효과적인 앱 릴리스를 지정하는 데 사용되는 내부 노드입니다. 디바이스 정책 또는 마지막 사용자 정책이 사용됩니다.

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/EffectiveRelease/ChannelId Windows 10, 버전 1809 추가되었습니다. 디바이스의 마지막 사용자 채널 ID를 반환합니다.

값 유형은 문자열입니다.

지원되는 작업은 Get입니다.

AppManagement/AppStore/ReleaseManagement/ReleaseManagementKey/EffectiveRelease/ReleaseManagementId Windows 10, 버전 1809 추가되었습니다. 디바이스에서 마지막 사용자 릴리스 ID를 반환합니다.

값 유형은 문자열입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName 선택 사항입니다. 앱의 PFN(패키지 패밀리 이름)입니다. 인벤토리를 보고할 때 디바이스의 각 PFN에 대해 하나씩 있습니다. 이러한 항목은 서명 원본 아래에 루팅됩니다.

지원되는 작업은 가져오기 및 삭제입니다.

참고

XAP 파일은 PackageFamilyName 대신 제품 ID를 사용합니다. 다음은 XAP 제품 ID(중괄호 포함) {12345678-9012-3456-7890-123456789012}의 예입니다.

다음은 앱을 제거하는 예제입니다.

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>

.../PackageFamilyName/PackageFullName 선택적. 설치된 패키지의 전체 이름입니다.

지원되는 작업은 가져오기 및 삭제입니다.

참고

XAP 파일은 PackageFullName 대신 제품 ID를 사용합니다. 다음은 XAP 제품 ID(중괄호 포함) {12345678-9012-3456-7890-123456789012}의 예입니다.

.../PackageFamilyName/PackageFullName/Name Required. 앱의 이름입니다.

값 유형은 문자열입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/Version Required. 앱의 버전입니다.

값 유형은 문자열입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/Publisher Required. 앱의 게시자 이름입니다.

값 유형은 문자열입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/Architecture Required. 설치된 패키지의 아키텍처입니다.

값 유형은 문자열입니다.

참고

XAP 파일에는 적용되지 않습니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/InstallLocation 필수 요소입니다. 디바이스에 앱의 위치를 설치합니다.

값 유형은 문자열입니다.

참고

XAP 파일에는 적용되지 않습니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/IsFramework 필수 요소입니다. 앱이 프레임워크 패키지인지 여부입니다. 값 형식은 int입니다. 앱이 프레임워크 패키지인 경우 값은 1이고 다른 모든 경우에는 0입니다.

참고

XAP 파일에는 적용되지 않습니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/IsBundle 필수 요소입니다. 패키지가 앱 번들인 경우 값은 1이고 다른 모든 경우에는 0입니다.

값 형식은 int입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/InstallDate 필수입니다. 앱이 설치된 날짜입니다.

값 유형은 문자열입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/ResourceID 필수입니다. 앱의 리소스 ID입니다. 이 값은 주 앱의 경우 null이고 번들의 경우 ~ 이며 리소스 패키지에 대한 리소스 정보를 포함합니다. 값 유형은 문자열입니다.

참고

XAP 파일에는 적용되지 않습니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/PackageStatus 필수 요소입니다. 패키지의 상태에 대한 정보를 제공합니다.

값 형식은 int입니다. 유효한 값은 다음과 같습니다.

  • OK (0) - 패키지를 사용할 수 있습니다.
  • LicenseIssue (1) - 패키지의 라이선스가 잘못되었습니다.
  • 수정됨 (2) - 패키지 페이로드가 알 수 없는 원본에 의해 수정되었습니다.
  • 변조됨 (4) - 패키지 페이로드가 의도적으로 변조되었습니다.
  • 사용 안 함 (8) - 패키지를 사용할 수 없습니다. 여전히 서비스할 수 있습니다.

참고

XAP 파일에는 적용되지 않습니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/RequiresReinstall Required. 패키지 상태가 변경되었으며 앱을 다시 설치해야 하는지 여부를 지정합니다. 이러한 상태 변경은 디바이스에 언어 기본 설정 또는 새 DPI가 변경된 경우와 같이 새 앱 리소스가 필요할 때 발생할 수 있습니다. 패키지가 손상되었을 수도 있습니다. 값이 1이면 앱 다시 설치가 수행됩니다. 값 형식은 int입니다.

참고

XAP 파일에는 적용되지 않습니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/Users Required. 앱 및 패키지 설치 상태의 등록된 사용자입니다. 쿼리가 디바이스 수준에 있으면 디바이스의 등록된 모든 사용자를 반환합니다. 사용자 컨텍스트를 쿼리하는 경우 현재 사용자만 반환합니다. 값 유형은 문자열입니다.

  • 설치되지 않음 = 0
  • 단계적 = 1
  • 설치됨 = 2
  • 일시 중지됨 = 6

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/IsProvisioned 필수 요소입니다. 값은 디바이스에서 앱이 프로비전되는지 여부를 나타내는 0 또는 1입니다.

값 형식은 int입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/PackageFullName/IsStub가 Windows 10 버전 2004에 추가되었습니다. 필수. 이 노드는 패키지가 스텁 패키지인지 여부를 식별하는 데 사용됩니다. 스텁 패키지는 앱 크기를 줄이는 최소한의 기능을 갖춘 패키지의 버전입니다.

패키지가 스텁 패키지인 경우 값은 1이고 다른 모든 경우에는 0입니다.

값 형식은 int입니다.

지원되는 작업은 Get입니다.

.../PackageFamilyName/DoNotUpdate 필수. 자동 업데이트를 통해 특정 앱이 업데이트되지 않도록 차단할지 여부를 지정합니다.

지원되는 작업은 추가, 가져오기, 삭제 및 바꾸기입니다.

.../PackageFamilyName/AppSettingPolicy(./User/Vendor/MSFT에만 해당) Windows 10 버전 1511에 추가되었습니다. 모든 관리되는 앱 설정 값에 대한 내부 노드입니다. 이 노드는 사용자 컨텍스트에서만 지원됩니다.

.../PackageFamilyName/AppSettingPolicy/SettingValue(./User/Vendor/MSFT에만 해당) Windows 10 버전 1511에 추가되었습니다. SettingValue 및 데이터는 앱에 대해 구성할 키 값 쌍을 나타냅니다. 노드는 키의 이름을 나타내고 데이터는 값을 나타냅니다. 이 값은 Managed.App.Settings 컨테이너의 LocalSettings에서 찾을 수 있습니다.

이 설정은 기능을 지원하는 앱에서만 작동하며 사용자 컨텍스트에서만 지원됩니다.

값 유형은 문자열입니다.

지원되는 작업은 추가, 가져오기, 바꾸기 및 삭제입니다.

다음 예제에서는 'Server'의 값을 설정합니다.

<!— Configure app settings -->
<Add>
   <CmdID>0</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy/Server</LocURI>
      </Target>
      <Meta>
         <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data>server1.contoso.com</Data>
   </Item>
</Add>

다음 예제에서는 특정 앱에 대한 모든 관리되는 앱 설정을 가져옵니다.

<!—Get app settings -->
<Get>
   <CmdID>0</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy?list=StructData</LocURI>
      </Target>
   </Item>
</Get>

.../PackageFamilyName/MaintainProcessorArchitectureOnUpdate Windows 10 버전 1803에 추가되었습니다. AMD64 디바이스의 앱 업데이트에서 설치된 앱의 아키텍처를 변경하지 않아야 하는지 여부를 지정합니다. 예를 들어 이 설정을 사용하도록 설정된 Windows 앱의 x86 버전이 업데이트 전체에서 설치된 경우 x64 버전을 사용할 수 있는 경우에도 x86 버전이 설치됩니다.

지원되는 작업은 추가, 가져오기, 삭제 및 바꾸기입니다.

값 유형은 정수입니다.

앱의 x86 버전이 설치된 AMD64 컴퓨터의 예상 동작(가장 제한적인 승리).

적용 가능성 설정 CSP 상태 결과
True 구성되지 않음 X86 맛 선택
True 설정됨 X86 맛 선택
True 해제됨 X86 맛 선택
False(설정되지 않음) 구성되지 않음 X64 맛이 선택됨

.../PackageFamilyName/NonRemovable Windows 10, 버전 1809 추가되었습니다. 사용자가 앱을 이동하지 않는지 지정합니다.

이 설정을 사용하면 IT 관리자가 앱을 복구할 수 없거나 사용자가 제거할 수 없도록 설정할 수 있습니다. 이 설정은 IT 관리자가 모든 사용자에게 항상 특정 앱이 있고 실수로 제거되지 않도록 할 수 있는 엔터프라이즈 및 교육 시나리오에서 유용합니다. 이 설정은 디바이스당 여러 사용자가 있고 한 사용자가 모든 사용자에 대해 제거하지 않도록 하려는 경우에도 유용합니다.

이동 가능하지 않은 경우 관리자 권한이 필요합니다. 이 설정은 사용자별로 정의할 수 없는 디바이스별로만 정의할 수 있습니다. AppInventoryQuery 또는 AppInventoryResults를 사용하여 설정을 쿼리할 수 있습니다.

값 유형은 정수입니다.

지원되는 작업은 추가, 가져오기 및 바꾸기입니다.

유효한 값:

  • 0 – 앱이 이동 불가능 앱 정책 목록에 없음
  • 1 – 앱이 이동 불가능 앱 정책 목록에 포함됨

예제:

이동 불가능한 앱 정책 목록에 앱 추가

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Add>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">int</Format>
                </Meta>
                <Data>1</Data>
            </Item>
        </Add>
        <Final/>
      </SyncBody>
</SyncML>

특정 앱의 상태 가져오기

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Get>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                </Target>
            </Item>
        </Get>
        <Final/>
    </SyncBody>
</SyncML>

이동 불가능한 앱 정책 목록의 앱 바꾸기 데이터 0 = 앱이 앱 정책 목록에 없는 경우 데이터 1 = 앱이 앱 정책 목록에 있습니다.

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Replace>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">int</Format>
                </Meta>
                <Data>0</Data>
            </Item>
        </Replace>
        <Final/>
    </SyncBody>
</SyncML>

AppInstallation 필수 노드입니다. 앱 설치를 수행하는 데 사용됩니다.

AppInstallation/PackageFamilyName 선택적 노드입니다. 앱의 PFN(패키지 패밀리 이름)입니다. 인벤토리를 보고할 때 디바이스의 각 PFN에 대해 하나씩 있습니다. 이러한 항목은 서명 원본 아래에 루팅됩니다.

지원되는 작업은 Get 및 Add입니다.

참고

XAP 파일은 PackageFamilyName 대신 제품 ID를 사용합니다. 다음은 XAP 제품 ID(중괄호 포함) {12345678-9012-3456-7890-123456789012}의 예입니다.

AppInstallation/PackageFamilyName/StoreInstall 필수. Microsoft Store에서 앱 및 라이선스 설치를 수행하는 명령입니다.

지원되는 작업은 실행, 추가, 삭제 및 가져오기입니다.

AppInstallation/PackageFamilyName/HostedInstall 필수. 호스트된 위치에서 앱 패키지 설치를 수행하는 명령입니다(이 위치는 로컬 드라이브, UNC 또는 https 데이터 원본일 수 있습니다).

다음 목록에는 지원되는 배포 옵션이 나와 있습니다.

  • ForceApplicationShutdown
  • DevelopmentMode
  • InstallAllResources
  • ForceTargetApplicationShutdown
  • ForceUpdateToAnyVersion
  • DeferRegistration="1". 설치 시 앱이 사용 중인 경우 이 옵션은 앱 업데이트에 대한 파일을 단계화하고 앱이 닫히면 앱 업데이트 등록을 완료합니다. 20H1의 최신 참가자 플라이트에서 사용할 수 있습니다.
  • StageOnly="1". 앱을 설치하지 않고 앱 설치 또는 업데이트에 대한 파일을 준비합니다. 1803에서 사용할 수 있습니다.
  • LicenseUri="\server\license.lic". 비즈니스용 Microsoft Store 오프라인 라이선스를 배포합니다. 1607에서 사용할 수 있습니다.
  • ValidateDependencies="1". 이 옵션은 프로비전/스테이징 시간에 사용됩니다. 1로 설정된 경우 배포는 등록 시 일반적으로 수행하는 것과 동일한 종속성 유효성 검사를 수행하며, 종속성이 없는 경우 프로비전 요청에 실패하고 거부합니다. 20H1의 최신 참가자 플라이트에서 사용할 수 있습니다.
  • ExcludeAppFromLayoutModification="1". 앱이 모든 디바이스에서 프로비전되고 시작 레이아웃에 고정하지 않고 프로비전된 앱을 유지할 수 있도록 설정합니다. 1809에서 사용할 수 있습니다.

지원되는 작업은 실행, 추가, 삭제 및 가져오기입니다.

AppInstallation/PackageFamilyName/LastError 필수. 앱 설치와 관련된 마지막 오류입니다.

지원되는 작업은 Get입니다.

참고

이 요소는 앱이 설치된 후에는 존재하지 않습니다.

AppInstallation/PackageFamilyName/LastErrorDesc 필수. 앱 설치와 관련된 마지막 오류에 대한 설명입니다.

지원되는 작업은 Get입니다.

참고

이 요소는 앱이 설치된 후에는 존재하지 않습니다.

AppInstallation/PackageFamilyName/Status 필수. 앱 설치의 상태입니다. 다음 값이 반환됩니다.

  • NOT_INSTALLED (0) - 노드가 추가되었지만 실행이 완료되지 않았습니다.
  • 설치(1) - 실행이 시작되었지만 배포가 완료되지 않았습니다. 성공에 관계없이 배포가 완료되면 이 값이 업데이트됩니다.
  • FAILED (2) - 설치에 실패했습니다. 오류의 세부 정보는 LastError 및 LastErrorDescription에서 찾을 수 있습니다.
  • INSTALLED (3) - 설치에 성공하면 이 노드가 정리되지만 정리 작업이 완료되지 않은 경우 이 상태가 잠시 나타날 수 있습니다.

지원되는 작업은 Get입니다.

참고

이 요소는 앱이 설치된 후에는 존재하지 않습니다.

AppInstallation/PackageFamilyName/ProgessStatus 필수. 앱 설치 진행률을 나타내는 정수입니다. https 위치의 경우 이 정수는 다운로드 진행률을 나타냅니다. ProgressStatus는 프로비저닝에 사용할 수 없으며 사용자 기반 설치에만 사용됩니다. ProgressStatus 값은 프로비저닝에서 항상 0입니다.

지원되는 작업은 Get입니다.

참고

이 요소는 앱이 설치된 후에는 존재하지 않습니다.

AppLicenses 필수 노드입니다. 앱 시나리오에 대한 라이선스를 관리하는 데 사용됩니다.

AppLicenses/StoreLicenses 필수 노드입니다. 스토어 앱에 대한 라이선스를 관리하는 데 사용됩니다.

AppLicenses/StoreLicenses/LicenseID 선택적 노드입니다. 스토어에 설치된 앱의 라이선스 ID입니다. 라이선스 ID는 일반적으로 앱의 PFN입니다.

지원되는 작업은 추가, 가져오기 및 삭제입니다.

AppLicenses/StoreLicenses/LicenseID/LicenseCategory Windows 10 버전 1511에 추가되었습니다. 필수. 다양한 라이선스 원본을 분류하는 데 사용되는 라이선스 범주입니다. 유효한 값은 다음과 같습니다.

  • 알 수 없음 - 알 수 없는 라이선스 범주
  • 소매 - 일반적으로 Microsoft Store에서 소매 채널을 통해 판매되는 라이선스
  • 엔터프라이즈 - 일반적으로 비즈니스용 스토어에서 엔터프라이즈 판매 채널을 통해 판매된 라이선스
  • OEM - OEM에 발급된 라이선스
  • 개발자 - 개발자 라이선스는 일반적으로 앱 개발 또는 테스트용 로드 시나리오 중에 설치됩니다.

지원되는 작업은 Get입니다.

AppLicenses/StoreLicenses/LicenseID/LicenseUsage Windows 10 버전 1511에 추가되었습니다. 필수. 라이선스에 허용되는 사용량을 나타냅니다. 유효한 값은 다음과 같습니다.

  • 알 수 없음 - 사용량을 알 수 없습니다.
  • 온라인 - 라이선스는 온라인 사용에만 유효합니다. 이 라이선스는 여러 컴퓨터에서 사용되는 앱과 같이 동시 요구 사항이 있는 애플리케이션용이지만 지정된 시간에 하나만 사용할 수 있습니다.
  • 오프라인 - 라이선스는 오프라인에서 사용할 수 있습니다. 이 라이선스를 사용하려면 인터넷에 연결할 필요가 없습니다.
  • 엔터프라이즈 루트 -

지원되는 작업은 Get입니다.

AppLicenses/StoreLicenses/LicenseID/RequesterID Windows 10 버전 1511에 추가되었습니다. 필수. 라이선스를 획득한 클라이언트와 같이 라이선스를 요청한 엔터티의 식별자입니다. 예를 들어 특정 엔터프라이즈 클라이언트에 대해 비즈니스용 스토어에서 발급한 모든 라이선스에는 동일한 RequesterID가 있습니다.

지원되는 작업은 Get입니다.

AppLicenses/StoreLicenses/LicenseID/AddLicense 필수. 라이선스를 추가하는 명령입니다.

지원되는 작업은 Execute입니다.

AppLicenses/StoreLicenses/LicenseID/GetLicenseFromStore Windows 10 버전 1511에 추가되었습니다. 필수. 스토어에서 라이선스를 가져오는 명령입니다.

지원되는 작업은 Execute입니다.

이 CSP를 사용하여 앱 인벤토리를 보고하고, 사용자를 위한 앱을 설치 및 제거하고, 디바이스에 앱을 프로비전하고, 앱 라이선스를 관리하는 방법에 대한 예는 엔터프라이즈 앱 관리를 참조하세요.

비스토어 앱과 같은 특정 앱 하위 범주에 대해 디바이스를 쿼리합니다.

<Get>
  <CmdID>1</CmdID>
  <Item>
    <Target>
      <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore</LocURI>
    </Target>
  </Item>
</Get>

결과에는 Data App1/App2/App/Data>>와 같은 <앱< 목록이 포함됩니다.

해당 속성에 대한 특정 앱에 대한 후속 쿼리입니다.

<Get>
   <CmdID>1</CmdID>
   <Item>
     <Target>
       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/App1?list=StructData</LocURI>
     </Target>
   </Item>
</Get>
<Get>
  <CmdID>2</CmdID>
  <Item>
    <Target>
      <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/App2?list=StructData</LocURI>
    </Target>
  </Item>
</Get>

구성 서비스 공급자 참조