MSIX Packages - Create Or Update

サービス:: Desktop Virtualization

API バージョン:: 2025-10-10

MSIX パッケージを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/msixPackages/{msixPackageFullName}?api-version=2025-10-10

URI パラメーター

名前	/	必須	型	説明
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	指定されたリソース・グループ内のホスト・プールの名前
msixPackageFullName	path	True	string minLength: 3 maxLength: 100 pattern: ^[A-Za-z0-9@.\-_ ]*$	指定されたホストプール内の MSIX パッケージのバージョン固有のパッケージのフルネーム
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	型	説明
properties.displayName	string	ポータルに表示されるユーザーフレンドリ名。
properties.imagePath	string	ネットワーク共有上の VHD/CIM イメージパス。
properties.isActive	boolean	このバージョンのパッケージをホストプール全体でアクティブにします。
properties.isRegularRegistration	boolean	フィードにパッケージを登録する方法を指定します。
properties.lastUpdated	string (date-time)	パッケージが最後に更新された日付。appxmanifest.xmlで見つかりました。
properties.packageApplications	MsixPackageApplications[]	パッケージアプリケーションの一覧。
properties.packageDependencies	MsixPackageDependencies[]	パッケージの依存関係の一覧。
properties.packageFamilyName	string	appxmanifest.xmlからのパッケージファミリ名。パッケージ名とパブリッシャー名が含まれます。
properties.packageName	string	appxmanifest.xmlからのパッケージ名。
properties.packageRelativePath	string	イメージ内のパッケージへの相対パス。
properties.version	string	appxmanifest.xmlで見つかったパッケージのバージョン。

応答

名前	型	説明
200 OK	MSIXPackage	MSIXパッケージを正常に更新しました。
201 Created	MSIXPackage	MSIXパッケージの作成に成功しました。
Other Status Codes	CloudError	操作が失敗した理由を説明する自動化エラー応答。

例

MSIXPackage_Create

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostpool1/msixPackages/msixpackagefullname?api-version=2025-10-10

{
  "properties": {
    "displayName": "displayname",
    "imagePath": "imagepath",
    "isActive": false,
    "isRegularRegistration": false,
    "lastUpdated": "2008-09-22T14:01:54.9571247Z",
    "packageApplications": [
      {
        "description": "application-desc",
        "appId": "ApplicationId",
        "appUserModelID": "AppUserModelId",
        "friendlyName": "friendlyname",
        "iconImageName": "Apptile",
        "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
        "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
      }
    ],
    "packageDependencies": [
      {
        "dependencyName": "MsixTest_Dependency_Name",
        "minVersion": "version",
        "publisher": "PublishedName"
      }
    ],
    "packageFamilyName": "MsixPackage_FamilyName",
    "packageName": "MsixPackage_name",
    "packageRelativePath": "packagerelativepath",
    "version": "version"
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "hostpool1/MsixPackageFullName",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourcegroups/resourcegroup1/providers/Microsoft.DesktopVirtualization/hostpools/hostpool1/msixpackages/msixPackageFullName",
  "type": "Microsoft.DesktopVirtualization/hostpools/msixpackages",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "imagePath": "imagepath",
    "packageName": "MsixPackage_Name",
    "packageFamilyName": "MsixPackage_FamilyName",
    "displayName": "dis",
    "packageRelativePath": "MsixPackage_RelativePackageRoot",
    "isRegularRegistration": false,
    "isActive": false,
    "packageDependencies": [
      {
        "dependencyName": "MsixPackage_Dependency_Name",
        "publisher": "MsixPackage_Dependency_Publisher",
        "minVersion": "packageDep_version"
      }
    ],
    "version": "version",
    "lastUpdated": "2008-09-22T14:01:54.9571247Z",
    "packageApplications": [
      {
        "appId": "Application_Id",
        "description": "desc",
        "appUserModelID": "Application_ModelID",
        "friendlyName": "fri",
        "iconImageName": "Apptile",
        "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
        "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
      }
    ]
  }
}

状態コード:: 201

{
  "name": "hostpool1/MsixPackageFullName",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourcegroups/resourcegroup1/providers/Microsoft.DesktopVirtualization/hostpools/hostpool1/msixpackages/msixPackageFullName",
  "type": "Microsoft.DesktopVirtualization/hostpools/msixpackages",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "imagePath": "imagepath",
    "packageName": "MsixPackage_Name",
    "packageFamilyName": "MsixPackage_FamilyName",
    "displayName": "dis",
    "packageRelativePath": "MsixPackage_RelativePackageRoot",
    "isRegularRegistration": false,
    "isActive": true,
    "packageDependencies": [
      {
        "dependencyName": "MsixPackage_Dependency_Name",
        "publisher": "MsixPackage_Dependency_Publisher",
        "minVersion": "packageDep_version"
      }
    ],
    "version": "version",
    "lastUpdated": "2008-09-22T14:01:54.9571247Z",
    "packageApplications": [
      {
        "appId": "Application_Id",
        "description": "desc",
        "appUserModelID": "Application_ModelID",
        "friendlyName": "fri",
        "iconImageName": "Apptile",
        "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
        "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
      }
    ]
  }
}

定義

名前	説明
CloudError	クラウドエラーオブジェクト。
CloudErrorProperties	クラウドエラーオブジェクトのプロパティ。
createdByType	リソースを作成した ID の種類。
MSIXPackage	MSIX パッケージプロパティのスキーマ。
MsixPackageApplications	MSIX パッケージアプリケーションのプロパティのスキーマ。
MsixPackageDependencies	MSIX パッケージの依存関係プロパティのスキーマ。
systemData	リソースの作成と最後の変更に関連するメタデータ。

CloudError

Object

クラウドエラーオブジェクト。

名前	型	説明
error	CloudErrorProperties	クラウドエラーオブジェクトのプロパティ。

CloudErrorProperties

Object

クラウドエラーオブジェクトのプロパティ。

名前	型	説明
code	string	エラーコード
message	string	操作が失敗した理由を示すエラーメッセージ。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

MSIXPackage

Object

MSIX パッケージプロパティのスキーマ。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.displayName	string	ポータルに表示されるユーザーフレンドリ名。
properties.imagePath	string	ネットワーク共有上の VHD/CIM イメージパス。
properties.isActive	boolean	このバージョンのパッケージをホストプール全体でアクティブにします。
properties.isRegularRegistration	boolean	フィードにパッケージを登録する方法を指定します。
properties.lastUpdated	string (date-time)	パッケージが最後に更新された日付。appxmanifest.xmlで見つかりました。
properties.packageApplications	MsixPackageApplications[]	パッケージアプリケーションの一覧。
properties.packageDependencies	MsixPackageDependencies[]	パッケージの依存関係の一覧。
properties.packageFamilyName	string	appxmanifest.xmlからのパッケージファミリ名。パッケージ名とパブリッシャー名が含まれます。
properties.packageName	string	appxmanifest.xmlからのパッケージ名。
properties.packageRelativePath	string	イメージ内のパッケージへの相対パス。
properties.version	string	appxmanifest.xmlで見つかったパッケージのバージョン。
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

MsixPackageApplications

Object

MSIX パッケージアプリケーションのプロパティのスキーマ。

名前	型	説明
appId	string	パッケージアプリケーション ID。appxmanifest.xmlにあります。
appUserModelID	string	パッケージアプリケーションをアクティブ化するために使用されます。パッケージ名と ApplicationID で構成されます。 appxmanifest.xmlで見つかりました.
description	string	パッケージアプリケーションの説明。
friendlyName	string	ユーザーフレンドリ名。
iconImageName	string	ユーザーフレンドリ名。
rawIcon	string (byte)	アイコンは、バイト配列としての 64 ビット文字列です。
rawPng	string (byte)	アイコンは、バイト配列としての 64 ビット文字列です。

MsixPackageDependencies

Object

MSIX パッケージの依存関係プロパティのスキーマ。

名前	型	説明
dependencyName	string	パッケージの依存関係の名前。
minVersion	string	依存関係のバージョンが必要です。
publisher	string	依存関係パブリッシャーの名前。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

MSIX Packages - Create Or Update

URI パラメーター

要求本文

応答

例

MSIXPackage_Create

要求のサンプル

応答のサンプル

定義

CloudError

CloudErrorProperties

createdByType

MSIXPackage

MsixPackageApplications

MsixPackageDependencies

systemData