你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Update-AzWvdAppAttachPackage

update an App Attach Package

Syntax

Update-AzWvdAppAttachPackage
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-FailHealthCheckOnStagingFailure <String>]
      [-HostPoolReference <String[]>]
      [-ImageCertificateExpiry <DateTime>]
      [-ImageCertificateName <String>]
      [-ImageDisplayName <String>]
      [-ImageIsActive]
      [-ImageIsPackageTimestamped <String>]
      [-ImageIsRegularRegistration]
      [-ImageLastUpdated <DateTime>]
      [-ImagePackageAlias <String>]
      [-ImagePackageApplication <IMsixPackageApplications[]>]
      [-ImagePackageDependency <IMsixPackageDependencies[]>]
      [-ImagePackageFamilyName <String>]
      [-ImagePackageFullName <String>]
      [-ImagePackageName <String>]
      [-ImagePackageRelativePath <String>]
      [-ImagePath <String>]
      [-ImageVersion <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzWvdAppAttachPackage
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-FailHealthCheckOnStagingFailure <String>]
      [-HostPoolReference <String[]>]
      [-ImageDisplayName <String>]
      [-ImageIsActive]
      [-ImageIsRegularRegistration]
      [-AppAttachPackage] <AppAttachPackage>
      [-PassThru]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzWvdAppAttachPackage
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzWvdAppAttachPackage
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzWvdAppAttachPackage
      -InputObject <IDesktopVirtualizationIdentity>
      [-FailHealthCheckOnStagingFailure <String>]
      [-HostPoolReference <String[]>]
      [-ImageCertificateExpiry <DateTime>]
      [-ImageCertificateName <String>]
      [-ImageDisplayName <String>]
      [-ImageIsActive]
      [-ImageIsPackageTimestamped <String>]
      [-ImageIsRegularRegistration]
      [-ImageLastUpdated <DateTime>]
      [-ImagePackageAlias <String>]
      [-ImagePackageApplication <IMsixPackageApplications[]>]
      [-ImagePackageDependency <IMsixPackageDependencies[]>]
      [-ImagePackageFamilyName <String>]
      [-ImagePackageFullName <String>]
      [-ImagePackageName <String>]
      [-ImagePackageRelativePath <String>]
      [-ImagePath <String>]
      [-ImageVersion <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

update an App Attach Package

Examples

Example 1: Update an Azure Virtual Desktop app attach package by name

$apps = "<PackagedApplication>"
$deps = "<PackageDependencies>"
Update-AzWvdAppAttachPackage -Name PackageArmObjectName `
                         -ResourceGroupName ResourceGroupName `
                         -SubscriptionId SubscriptionId `
                         -ImageDisplayName displayname `
                         -ImagePath imageURI `
                         -ImageIsActive:$false `
                         -ImageIsRegularRegistration:$false `
                         -ImageLastUpdated datelastupdated `
                         -ImagePackageApplication $apps `
                         -ImagePackageDependency $deps `
                         -ImagePackageFamilyName packagefamilyname `
                         -ImagePackageName packagename `
                         -ImagePackageFullName packagefullname `
                         -ImagePackageRelativePath packagerelativepath `
                         -ImageVersion packageversion `
                         -ImageCertificateExpiry certificateExpiry `
                         -ImageCertificateName certificateName `
                         -KeyVaultUrl keyvaultUrl `
                         -FailHealthCheckOnStagingFailure 'Unhealthy'

Location   Name                 Type
--------   ----                 ----
eastus     PackageArmObjectName Microsoft.DesktopVirtualization/appattachpackages

This command updates an Azure Virtual Desktop App attach package in a resource group.

Example 2: Create an Azure Virtual Desktop app attach package from an appAttachPackage object

Update-AzWvdAppAttachPackage -Name PackageArmObjectName `
                         -ResourceGroupName ResourceGroupName `
                         -SubscriptionId SubscriptionId `
                         -DisplayName displayname `
                         -AppAttachPackage imageObject `
                         -IsActive:$false `
                         -IsLogonBlocking:$false `
                         -KeyVaultUrl keyvaultUrl `
                         -FailHealthCheckOnStagingFailure 'Unhealthy' `
                         -HostpoolReference hostpoolReference `
                         -PassThru

Location   Name                 Type
--------   ----                 ----
eastus     PackageArmObjectName Microsoft.DesktopVirtualization/appattachpackages

This command updates an Azure Virtual Desktop App Attach Package in a resource group using the output of the Import-AzWvdAppAttachPackageInfo command.

Parameters

-AppAttachPackage

Type:AppAttachPackage
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailHealthCheckOnStagingFailure

Parameter indicating how the health check should behave if this package fails staging

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostPoolReference

List of Hostpool resource Ids.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageCertificateExpiry

Date certificate expires, found in the appxmanifest.xml.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageCertificateName

Certificate name found in the appxmanifest.xml.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageDisplayName

User friendly Name to be displayed in the portal.

Type:String
Aliases:DisplayName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageIsActive

Make this version of the package the active one across the hostpool.

Type:SwitchParameter
Aliases:IsActive
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageIsPackageTimestamped

Is package timestamped so it can ignore the certificate expiry date

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageIsRegularRegistration

Specifies how to register Package in feed.

Type:SwitchParameter
Aliases:IsRegularRegistration, IsLogonBlocking
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageLastUpdated

Date Package was last updated, found in the appxmanifest.xml.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageAlias

Alias of App Attach Package. Assigned at import time

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageApplication

List of package applications.

Type:IMsixPackageApplications[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageDependency

List of package dependencies.

Type:IMsixPackageDependencies[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageFamilyName

Package Family Name from appxmanifest.xml. Contains Package Name and Publisher name.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageFullName

Package Full Name from appxmanifest.xml.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageName

Package Name from appxmanifest.xml.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageRelativePath

Relative Path to the package inside the image.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePath

VHD/CIM image path on Network Share.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageVersion

Package version found in the appxmanifest.xml.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Identity Parameter

Type:IDesktopVirtualizationIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JsonFilePath

Path of Json file supplied to the Update operation

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JsonString

Json string supplied to the Update operation

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

The name of the App Attach package

Type:String
Aliases:AppAttachPackageName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

The name of the resource group. The name is case insensitive.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

The ID of the target subscription. The value must be an UUID.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

AppAttachPackage

IDesktopVirtualizationIdentity

Outputs

IAppAttachPackage