你当前正在访问 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
IDesktopVirtualizationIdentity