Add-AzureVMImage
Adiciona uma nova imagem do sistema operacional ou uma nova imagem de máquina virtual ao repositório de imagens.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Syntax
Add-AzureVMImage
[-ImageName] <String>
[-MediaLocation] <String>
[-OS] <String>
[[-Label] <String>]
[[-Eula] <String>]
[[-Description] <String>]
[[-ImageFamily] <String>]
[[-PublishedDate] <DateTime>]
[[-PrivacyUri] <Uri>]
[[-RecommendedVMSize] <String>]
[[-IconName] <String>]
[[-SmallIconName] <String>]
[-ShowInGui]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Add-AzureVMImage
[-ImageName] <String>
[-DiskConfig] <VirtualMachineImageDiskConfigSet>
[[-OS] <String>]
[[-Label] <String>]
[[-Eula] <String>]
[[-Description] <String>]
[[-ImageFamily] <String>]
[[-PublishedDate] <DateTime>]
[[-PrivacyUri] <Uri>]
[[-RecommendedVMSize] <String>]
[[-IconName] <String>]
[[-SmallIconName] <String>]
[-ShowInGui]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet Add-AzureVMImage adiciona uma nova imagem do sistema operacional ou uma nova imagem de máquina virtual ao repositório de imagens. A imagem é uma imagem generalizada do sistema operacional, usando Sysprep para Windows ou, para Linux, usando a ferramenta apropriada para a distribuição.
Exemplos
Exemplo 1: Adicionar uma imagem do sistema operacional ao repositório
PS C:\> $S = New-AzureVMImageDiskConfigSet
PS C:\> Set-AzureVMImageOSDiskConfig -DiskConfig $S -HostCaching ReadWrite -OSState "Generalized" -OS "Windows" -MediaLink $Link
PS C:\> Set-AzureVMImageDataDiskConfig -DiskConfig $S -DataDiskName "Test1" -HostCaching ReadWrite -Lun 0 -MediaLink $Link1
PS C:\> Set-AzureVMImageDataDiskConfig -DiskConfig $S -DataDiskName "Test4" -HostCaching ReadWrite -Lun 0 -MediaLink $Link
PS C:\> Remove-AzureVMImageDataDiskConfig -DiskConfig $S -DataDiskName "Test4"
PS C:\> $IMGName = "TestCREATEvmimage2";
PS C:\> Add-AzureVMImage -ImageName $IMGName -Label "Test1" -Description "Test1" -DiskConfig $S -Eula "http://www.contoso.com" -ImageFamily Windows -PublishedDate (Get-Date) -PrivacyUri "http://www.test.com" -RecommendedVMSize Small -IconName "Icon01" -SmallIconName "SmallIcon01" -ShowInGui
Este exemplo adiciona uma imagem do sistema operacional ao repositório.
Parâmetros
-Description
Especifica a descrição da imagem do sistema operacional.
Tipo: | String |
Position: | 5 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskConfig
Especifica a configuração de disco do sistema operacional para a imagem da máquina virtual.
Tipo: | VirtualMachineImageDiskConfigSet |
Position: | 1 |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Eula
Especifica o Contrato de Licença de Usuário Final. É recomendável usar uma URL para esse valor.
Tipo: | String |
Position: | 4 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IconName
Especifica o nome do ícone usado quando a imagem é adicionada ao repositório.
Tipo: | String |
Aliases: | IconUri |
Position: | 10 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageFamily
Especifica um valor que é usado para agrupar imagens do sistema operacional.
Tipo: | String |
Position: | 6 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageName
Especifica o nome da imagem que está sendo adicionada ao repositório de imagens.
Tipo: | String |
Position: | 0 |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
Tipo: | ActionPreference |
Aliases: | infa |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Especifica uma variável de informação.
Tipo: | String |
Aliases: | iv |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Especifica um rótulo para fornecer a imagem.
Tipo: | String |
Position: | 3 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MediaLocation
Especifica o local da página de blob física onde a imagem reside. Este é um link para uma página de blob no armazenamento da assinatura atual.
Tipo: | String |
Position: | 1 |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OS
Especifica a versão do sistema operacional da imagem.
Tipo: | String |
Position: | 2 |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivacyUri
Especifica a URL que aponta para um documento que contém a política de privacidade relacionada à imagem do sistema operacional.
Tipo: | Uri |
Position: | 8 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Tipo: | AzureSMProfile |
Position: | Named |
valor predefinido: | None |
Necessário: | 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.
Tipo: | DateTime |
Position: | 7 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RecommendedVMSize
Especifica o tamanho a ser usado para a máquina virtual criada a partir da imagem do sistema operacional.
Os valores aceitáveis para este parâmetro são:
- Médio
- Grande
- ExtraGrande
- A5
- A6
- A7
Tipo: | String |
Position: | 9 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShowInGui
Indica que esse cmdlet mostra a imagem na GUI.
Tipo: | SwitchParameter |
Position: | 12 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SmallIconName
Especifica o nome do pequeno ícone que é usado quando a imagem é adicionada ao repositório.
Tipo: | String |
Aliases: | SmallIconUri |
Position: | 11 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Saídas
OSImageContext