Share via

Add-AzureVMImage

  • Referencia
Módulo:
Azure

Agrega una nueva imagen de sistema operativo o una nueva imagen de máquina virtual al repositorio de imágenes.

Nota

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de 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

El cmdlet Add-AzureVMImage agrega una nueva imagen de sistema operativo o una nueva imagen de máquina virtual al repositorio de imágenes. La imagen es una imagen de sistema operativo generalizada, mediante Sysprep para Windows o, para Linux, mediante la herramienta adecuada para la distribución.

Ejemplos

Ejemplo 1: Adición de una imagen de sistema operativo al repositorio

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

En este ejemplo se agrega una imagen de sistema operativo al repositorio.

Parámetros

-Description

Especifica la descripción de la imagen del sistema operativo.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskConfig

Especifica la configuración del disco del sistema operativo para la imagen de máquina virtual.

Type:VirtualMachineImageDiskConfigSet
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Eula

Especifica el Contrato de licencia de usuario final. Se recomienda usar una dirección URL para este valor.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IconName

Especifica el nombre del icono que se usa cuando se agrega la imagen al repositorio.

Type:String
Aliases:IconUri
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageFamily

Especifica un valor que se usa para agrupar imágenes de sistema operativo.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageName

Especifica el nombre de la imagen que se va a agregar al repositorio de imágenes.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica una variable de información.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Label

Especifica una etiqueta para proporcionar la imagen.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MediaLocation

Especifica la ubicación de la página del blob físico donde reside la imagen. Se trata de un vínculo a una página de blobs en el almacenamiento de la suscripción actual.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OS

Especifica la versión del sistema operativo de la imagen.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PrivacyUri

Especifica la dirección URL que apunta a un documento que contiene la directiva de privacidad relacionada con la imagen del sistema operativo.

Type:Uri
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishedDate

Especifica la fecha en que se agregó la imagen del sistema operativo al repositorio de imágenes.

Type:DateTime
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RecommendedVMSize

Especifica el tamaño que se va a usar para la máquina virtual que se crea a partir de la imagen del sistema operativo.

Los valores permitidos para este parámetro son los siguientes:

  • Media
  • Grande
  • ExtraLarge
  • A5
  • A6
  • A7
Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShowInGui

Indica que este cmdlet muestra la imagen en la GUI.

Type:SwitchParameter
Position:12
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SmallIconName

Especifica el nombre del icono pequeño que se usa cuando se agrega la imagen al repositorio.

Type:String
Aliases:SmallIconUri
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Salidas

OSImageContext