Update-AzureVMImage
Atualiza o rótulo de uma imagem do sistema operacional no repositório de imagens.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
Update-AzureVMImage
[-ImageName] <String>
[-Label] <String>
[[-Eula] <String>]
[[-Description] <String>]
[[-ImageFamily] <String>]
[[-PublishedDate] <DateTime>]
[[-PrivacyUri] <Uri>]
[[-RecommendedVMSize] <String>]
[[-DiskConfig] <VirtualMachineImageDiskConfigSet>]
[[-Language] <String>]
[[-IconName] <String>]
[[-SmallIconName] <String>]
[-DontShowInGui]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet Update-AzureVMImage atualiza o rótulo em uma imagem do sistema operacional no repositório de imagens. Ele retorna um objeto de imagem com informações sobre a imagem atualizada.
Exemplos
Exemplo 1: Atualizar uma imagem alterando o rótulo da imagem
PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"
Esse comando atualiza a imagem chamada Windows-Server-2008-SP2 alterando o rótulo da imagem para DoNotUse.
Exemplo 2: Obter todos os sistemas operacionais por rótulo e, em seguida, atualizar o rótulo
PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"
Esse comando obtém todas as imagens do sistema operacional rotuladas como DoNotUse e altera o rótulo para Atualizado.
Parâmetros
-Description
Especifica a descrição da imagem do sistema operacional.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskConfig
Especifica a configuração do disco do sistema operacional e do disco de dados para a imagem da máquina virtual criada usando os cmdlets New-AzureVMImageDiskConfigSet, Set-AzureVMImageOSDiskConfig e Set-AzureVMImageDataDiskConfig.
Type: | VirtualMachineImageDiskConfigSet |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DontShowInGui
Indica que esse cmdlet não mostra a imagem na GUI.
Type: | SwitchParameter |
Position: | 12 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Eula
Especifica o Contrato de Licença de Usuário Final. Recomendamos que o valor seja uma URL.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IconName
Especifica o nome do ícone padrão para a imagem do sistema operacional ou da máquina virtual.
Type: | String |
Aliases: | IconUri |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageFamily
Especifica um valor que pode ser usado para agrupar imagens do sistema operacional ou da máquina virtual.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageName
Especifica o nome da imagem a ser atualizada no repositório de imagens.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informações.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Especifica uma variável de informação.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Especifica o novo rótulo da imagem.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Language
Especifica o idioma do sistema operacional na máquina virtual ou na imagem do sistema operacional.
Type: | String |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivacyUri
Especifica o URI que aponta para um documento que contém a política de privacidade relacionada à imagem do sistema operacional.
Type: | Uri |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublishedDate
Especifica a data em que a imagem do sistema operacional foi adicionada ao repositório de imagens.
Type: | DateTime |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RecommendedVMSize
Especifica o tamanho da máquina virtual.
Os valores aceitáveis para esse parâmetro são:
- Médio
- grande
- ExtraLarge
- A5
- A6
- A7
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SmallIconName
Especifica o nome do pequeno ícone para a imagem do sistema operacional ou da máquina virtual.
Type: | String |
Aliases: | SmallIconUri |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Saídas
OSImageContext