Compartilhar via

New-AzGalleryApplicationVersion

  • Referência
Módulo:
Az.Compute

Crie ou atualize uma versão do aplicativo da galeria.

Sintaxe

New-AzGalleryApplicationVersion
   -GalleryApplicationName <String>
   -GalleryName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -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

Crie ou atualize uma versão do aplicativo da galeria.

Exemplos

Exemplo 1: criar uma versão do aplicativo de galeria.

$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"

Criando uma versão do aplicativo Gallery. Usando o URI SAS para o blob de PackageFileLink.

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConfigFileName

Opcional. O nome para atribuir o arquivo de configuração baixado na VM. Isso é limitado a 4096 caracteres. Se não for especificado, o arquivo de configuração será nomeado como o nome do aplicativo da Galeria anexado com "_config".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultConfigFileLink

Opcional. O defaultConfigurationLink do artefato deve ser um blob de páginas de armazenamento legível.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GalleryApplicationName

O nome da Definição do Aplicativo da galeria na qual a Versão do Aplicativo deve ser criada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GalleryName

O nome da Galeria de Aplicativos Compartilhados na qual a Definição de Aplicativo reside.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Install

Obrigatória. O caminho e os argumentos para instalar o aplicativo da galeria. Isso é limitado a 4096 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Local do recurso

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome da galeria Versão do aplicativo a ser criada. Precisa seguir o padrão de nome de versão semântica: os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits. Formato: <MajorVersion>.<Versão menor>.<Remendo>

Tipo:String
Aliases:GalleryApplicationVersionName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWait

Execute o comando de forma assíncrona

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageFileLink

Obrigatória. O mediaLink do artefato deve ser um blob de páginas de armazenamento legível.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageFileName

Opcional. O nome para atribuir o arquivo de pacote baixado na VM. Isso é limitado a 4096 caracteres. Se não for especificado, o arquivo de pacote terá o mesmo nome do aplicativo da Galeria.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublishingProfileEndOfLifeDate

A data de fim da vida útil da versão da imagem da galeria. Esta propriedade pode ser usada para fins de desativação. Essa propriedade é atualizável.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublishingProfileExcludeFromLatest

Se definido como true, as Máquinas Virtuais implantadas da versão mais recente da Definição de Imagem não usarão essa Versão da Imagem.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Remove

Obrigatória. O caminho e os argumentos para remover o aplicativo da galeria. Isso é limitado a 4096 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicaCount

O número de réplicas da versão da imagem a serem criadas por região. Essa propriedade entraria em vigor para uma região quando regionalReplicaCount não fosse especificado. Essa propriedade é atualizável.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubscriptionId

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

Marcações de recursos

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TargetRegion

As regiões de destino para as quais a versão da imagem será replicada. Essa propriedade é atualizável. Para construir, consulte a seção NOTAS para propriedades TARGETREGION e crie uma tabela de hash.

Tipo:ITargetRegion[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Update

Opcional. O caminho e os argumentos para atualizar o aplicativo da galeria. Se não estiver presente, a operação de atualização invocará o comando remove na versão anterior e o comando install na versão atual do aplicativo da galeria. Isso é limitado a 4096 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

IGalleryApplicationVersion