App Attach Package - Update

サービス:: Desktop Virtualization

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

アプリアタッチパッケージの更新

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/appAttachPackages/{appAttachPackageName}?api-version=2025-10-10

URI パラメーター

名前	/	必須	型	説明
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	アプリ接続パッケージの名前
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	型	説明
properties	AppAttachPackagePatchProperties	アプリ添付パッケージの詳細なプロパティ

応答

名前	型	説明
200 OK	AppAttachPackage	App Attachパッケージを正常に更新しました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明する自動化エラー応答。

例

AppAttachPackage_Update

要求のサンプル

HTTP

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

応答のサンプル

状態コード:: 200

{
  "name": "packageName",
  "id": "/subscriptions/d15725f7-6577-4a8c-95f1-3da903b42364/resourcegroups/charlesk-southcentralus/providers/Microsoft.DesktopVirtualization/appattachpackages/ModifierPackage",
  "type": "Microsoft.DesktopVirtualization/appattachpackages",
  "location": "southcentralus",
  "tags": {},
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2023-09-28T23:44:56.13Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-10-09T01:43:31.07Z"
  },
  "properties": {
    "image": {
      "packageAlias": "msixpackagealias",
      "imagePath": "imagepath",
      "packageName": "MsixPackageName",
      "packageFamilyName": "MsixPackage_FamilyName",
      "packageFullName": "MsixPackage_FullName",
      "displayName": "displayname",
      "packageRelativePath": "packagerelativepath",
      "isRegularRegistration": false,
      "isActive": false,
      "packageDependencies": [
        {
          "dependencyName": "MsixPackage_Dependency_Name",
          "publisher": "MsixPackage_Dependency_Publisher",
          "minVersion": "packageDep_version"
        }
      ],
      "version": "packageversion",
      "lastUpdated": "2008-09-22T14:01:54.9571247Z",
      "packageApplications": [
        {
          "appId": "AppId",
          "description": "PackageApplicationDescription",
          "appUserModelID": "AppUserModelId",
          "friendlyName": "FriendlyName",
          "iconImageName": "Iconimagename",
          "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
          "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
        }
      ],
      "certificateName": "certName",
      "certificateExpiry": "2023-01-02T17:18:19.1234567Z"
    },
    "hostPoolReferences": [],
    "failHealthCheckOnStagingFailure": "NeedsAssistance",
    "keyVaultURL": ""
  }
}

定義

名前	説明
AppAttachPackage	アプリ添付パッケージのプロパティのスキーマ。
AppAttachPackageInfoProperties	パッケージ情報のインポートプロパティのスキーマ。
AppAttachPackagePatch	更新可能なアプリ接続パッケージのプロパティのスキーマ。
AppAttachPackagePatchProperties	アプリケーションアタッチパッケージのパッチ可能なフィールドのスキーマ。
AppAttachPackageProperties	アプリ添付パッケージのプロパティのスキーマ。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
failHealthCheckOnStagingFailure	このパッケージがステージングに失敗した場合の正常性チェックの動作を示すパラメーター
MsixPackageApplications	MSIX パッケージアプリケーションのプロパティのスキーマ。
MsixPackageDependencies	MSIX パッケージの依存関係プロパティのスキーマ。
packageTimestamped	証明書の有効期限を無視できるように、パッケージのタイムスタンプが付きます
ProvisioningState	現在のプロビジョニング状態。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AppAttachPackage

Object

アプリ添付パッケージのプロパティのスキーマ。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	リソースが存在する地理的な場所
name	string	リソースの名前
properties	AppAttachPackageProperties	アプリ添付パッケージの詳細なプロパティ
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
tags	object	リソースタグ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Object

パッケージ情報のインポートプロパティのスキーマ。

名前	型	説明
certificateExpiry	string (date-time)	証明書の有効期限が切れる日付。appxmanifest.xmlにあります。
certificateName	string	appxmanifest.xmlで見つかった証明書名。
displayName	string	ポータルに表示されるユーザーフレンドリ名。
imagePath	string	ネットワーク共有上の VHD/CIM イメージパス。
isActive	boolean	このバージョンのパッケージをホストプール全体でアクティブにします。
isPackageTimestamped	packageTimestamped	証明書の有効期限を無視できるように、パッケージのタイムスタンプが付きます
isRegularRegistration	boolean	フィードにパッケージを登録する方法を指定します。
lastUpdated	string (date-time)	パッケージが最後に更新された日付。appxmanifest.xmlで見つかりました。
packageAlias	string	アプリアタッチパッケージのエイリアス。インポート時に割り当てられます
packageApplications	MsixPackageApplications[]	パッケージアプリケーションの一覧。
packageDependencies	MsixPackageDependencies[]	パッケージの依存関係の一覧。
packageFamilyName	string	appxmanifest.xmlからのパッケージファミリ名。パッケージ名とパブリッシャー名が含まれます。
packageFullName	string	appxmanifest.xmlから完全な名前をパッケージ化します。
packageName	string	appxmanifest.xmlからのパッケージ名。
packageRelativePath	string	イメージ内のパッケージへの相対パス。
version	string	appxmanifest.xmlで見つかったパッケージのバージョン。

AppAttachPackagePatch

Object

更新可能なアプリ接続パッケージのプロパティのスキーマ。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties	AppAttachPackagePatchProperties	アプリ添付パッケージの詳細なプロパティ
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AppAttachPackagePatchProperties

Object

アプリケーションアタッチパッケージのパッチ可能なフィールドのスキーマ。

名前	型	説明
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	このパッケージがステージングに失敗した場合の正常性チェックの動作を示すパラメーター
hostPoolReferences	string[] (arm-id)	Hostpool リソース ID の一覧。
image	AppAttachPackageInfoProperties	アプリ添付パッケージの詳細なプロパティ
keyVaultURL	string	keyVault にある証明書名への URL パス

AppAttachPackageProperties

Object

アプリ添付パッケージのプロパティのスキーマ。

名前	型	説明
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	このパッケージがステージングに失敗した場合の正常性チェックの動作を示すパラメーター
hostPoolReferences	string[]	Hostpool リソース ID の一覧。
image	AppAttachPackageInfoProperties	アプリ添付パッケージの詳細なプロパティ
keyVaultURL	string	keyVault にある証明書名への URL パス
provisioningState	ProvisioningState	アプリ接続パッケージのプロビジョニング状態。

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

failHealthCheckOnStagingFailure

列挙

このパッケージがステージングに失敗した場合の正常性チェックの動作を示すパラメーター

値	説明
Unhealthy
NeedsAssistance
DoNotFail

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	依存関係パブリッシャーの名前。

packageTimestamped

列挙

証明書の有効期限を無視できるように、パッケージのタイムスタンプが付きます

値	説明
Timestamped
NotTimestamped

ProvisioningState

列挙

現在のプロビジョニング状態。

値	説明
Succeeded
Provisioning
Failed
Canceled

systemData

Object

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

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

次の方法で共有

App Attach Package - Update

URI パラメーター

要求本文

応答

例

AppAttachPackage_Update

要求のサンプル

応答のサンプル

定義

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData