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 de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.
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.
Type: | String |
Position: | 5 |
Default value: | None |
Required: | 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.
Type: | VirtualMachineImageDiskConfigSet |
Position: | 1 |
Default value: | None |
Required: | 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.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IconName
Especifica o nome do ícone usado quando a imagem é adicionada ao repositório.
Type: | String |
Aliases: | IconUri |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageFamily
Especifica um valor que é usado para agrupar imagens do sistema operacional.
Type: | String |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageName
Especifica o nome da imagem que está sendo adicionada ao 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ção.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
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 um rótulo para fornecer a imagem.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MediaLocation
Especifica o local da página de blob físico onde a imagem reside. Este é um link para uma página de blob no armazenamento da assinatura atual.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OS
Especifica a versão do sistema operacional da imagem.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | 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.
Type: | Uri |
Position: | 8 |
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 é lido. 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: | 7 |
Default value: | None |
Required: | 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:
- Meio
- Grande
- ExtraGrande
- A5
- A6
- A7
Type: | String |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShowInGui
Indica que esse cmdlet mostra a imagem na GUI.
Type: | SwitchParameter |
Position: | 12 |
Default value: | None |
Required: | 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.
Type: | String |
Aliases: | SmallIconUri |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Saídas
OSImageContext