New-AzGalleryApplicationVersion
Cree o actualice una versión de aplicación de la galería.
Sintaxis
CreateExpanded (valor predeterminado)
New-AzGalleryApplicationVersion
-Name <String>
-GalleryApplicationName <String>
-GalleryName <String>
-ResourceGroupName <String>
-Location <String>
-Install <String>
-Remove <String>
[-SubscriptionId <String>]
[-DefaultConfigFileLink <String>]
[-PackageFileLink <String>]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <ITargetRegion[]>]
[-Update <String>]
[-PackageFileName <String>]
[-ConfigFileName <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityGalleryExpanded
New-AzGalleryApplicationVersion
-Name <String>
-GalleryApplicationName <String>
-GalleryInputObject <IComputeIdentity>
-Location <String>
-Install <String>
-Remove <String>
[-DefaultConfigFileLink <String>]
[-PackageFileLink <String>]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <ITargetRegion[]>]
[-Update <String>]
[-PackageFileName <String>]
[-ConfigFileName <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonFilePath
New-AzGalleryApplicationVersion
-Name <String>
-GalleryApplicationName <String>
-GalleryName <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzGalleryApplicationVersion
-Name <String>
-GalleryApplicationName <String>
-GalleryName <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityApplicationExpanded
New-AzGalleryApplicationVersion
-Name <String>
-ApplicationInputObject <IComputeIdentity>
-Location <String>
-Install <String>
-Remove <String>
[-DefaultConfigFileLink <String>]
[-PackageFileLink <String>]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <ITargetRegion[]>]
[-Update <String>]
[-PackageFileName <String>]
[-ConfigFileName <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cree o actualice una versión de aplicación de la galería.
Ejemplos
Ejemplo 1: Creación de una versión de aplicación de la galería.
$ctx = New-AzStorageContext -StorageAccountName $storAccName
$SASToken = New-AzStorageBlobSASToken -Context $ctx -Container $containerName -blob $blobName -Permission r
$storAcc = Get-AzStorageAccount -ResourceGroupName $rgName -Name $storAccName
$blob = Get-AzStorageBlob -Container $containerName -Blob $blobName -Context $storAcc.Context
$SASToken = New-AzStorageBlobSASToken -Container $containerName -Blob $blobName -Permission rwd -Context $storAcc.Context
$SASUri = $blob.ICloudBlob.Uri.AbsoluteUri + $SASToken
New-AzGalleryApplicationVersion -ResourceGroupName $rgname -Location EastUS -GalleryName $galleryName -GalleryApplicationName $galleryApplicationName -name "0.1.0" -PackageFileLink $SASUri -Install "powershell -command 'Expand-Archive -Path package.zip -DestinationPath C:\\package\'" -Remove "del C:\\package"
Creación de una versión de aplicación de la galería.
Uso del URI de SAS para el blob para PackageFileLink.
Parámetros
Parámetro de identidad
Tipo: IComputeIdentity
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: True
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-AsJob
Ejecución del comando como trabajo
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ConfigFileName
Optional.
Nombre para asignar el archivo de configuración descargado en la máquina virtual.
Se limita a 4096 caracteres.
Si no se especifica, el archivo de configuración se denominará Nombre de aplicación de la galería anexado con "_config".
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: cf
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DefaultConfigFileLink
Optional.
DefaultConfigurationLink del artefacto debe ser un blob en páginas de almacenamiento legible.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DefaultProfile
El parámetro DefaultProfile no es funcional.
Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.
Propiedades de parámetro
Tipo: PSObject
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: AzureRMContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-GalleryApplicationName
Nombre de la definición de aplicación de la galería en la que se va a crear la versión de la aplicación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonFilePath
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonString
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
Parámetro de identidad
Tipo: IComputeIdentity
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: True
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-GalleryName
Nombre de la Galería de aplicaciones compartidas en la que reside la definición de aplicación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonFilePath
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonString
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Install
Obligatorio.
Ruta de acceso y argumentos para instalar la aplicación de la galería.
Se limita a 4096 caracteres.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-JsonFilePath
Ruta de acceso del archivo Json proporcionado a la operación Create
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateViaJsonFilePath
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-JsonString
Cadena JSON proporcionada a la operación Create
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateViaJsonString
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Location
Ubicación del recurso
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Name
Nombre de la versión de aplicación de la galería que se va a crear.
Debe seguir el patrón de nombre de versión semántica: los caracteres permitidos son dígitos y puntos.
Los dígitos deben estar dentro del intervalo de un entero de 32 bits.
Formato: <MajorVersion>.<MinorVersion>.<Parche>
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: GalleryApplicationVersionName
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-NoWait
Ejecutar el comando de forma asincrónica
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-PackageFileLink
Obligatorio.
El mediaLink del artefacto debe ser un blob en páginas de almacenamiento legible.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-PackageFileName
Optional.
Nombre para asignar el archivo de paquete descargado en la máquina virtual.
Se limita a 4096 caracteres.
Si no se especifica, el archivo de paquete se denominará igual que el nombre de la aplicación de la galería.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-PublishingProfileEndOfLifeDate
Fecha de finalización del ciclo de vida de la versión de la imagen de la galería.
Esta propiedad se puede usar con fines de retirada.
Esta propiedad es actualizable.
Propiedades de parámetro
Tipo: DateTime
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-PublishingProfileExcludeFromLatest
Si se establece en true, las máquinas virtuales implementadas desde la versión más reciente de la definición de imagen no usarán esta versión de imagen.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Remove
Obligatorio.
Ruta de acceso y argumentos para quitar la aplicación de la galería.
Se limita a 4096 caracteres.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ReplicaCount
Número de réplicas de la versión de imagen que se va a crear por región.
Esta propiedad surtiría efecto para una región cuando no se especifica regionalReplicaCount.
Esta propiedad es actualizable.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ResourceGroupName
Nombre del grupo de recursos.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonFilePath
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonString
Posición: Named
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-SubscriptionId
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure.
El identificador de suscripción forma parte del URI de cada llamada de servicio.
Propiedades de parámetro
Tipo: String
Valor predeterminado: (Get-AzContext).Subscription.Id
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonFilePath
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaJsonString
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Tag
Etiquetas de recursos
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-TargetRegion
Las regiones de destino en las que se va a replicar la versión de la imagen.
Esta propiedad es actualizable.
Propiedades de parámetro
Tipo: ITargetRegion [ ]
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-Update
Optional.
Ruta de acceso y argumentos para actualizar la aplicación de la galería.
Si no está presente, la operación de actualización invocará el comando remove en la versión anterior e instalará el comando en la versión actual de la aplicación de la galería.
Se limita a 4096 caracteres.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
CreateExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityGalleryExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CreateViaIdentityApplicationExpanded
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta.
El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: Wi
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas