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 heredados de Azure que usan las API de Azure Service Manager (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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.

Tipo:String
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DiskConfig

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

Tipo:VirtualMachineImageDiskConfigSet
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Eula

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

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-IconName

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

Tipo:String
Alias:IconUri
Posición:10
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ImageFamily

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

Tipo:String
Posición:6
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ImageName

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

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Label

Especifica una etiqueta para proporcionar la imagen.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-OS

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

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Uri
Posición:8
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

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

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublishedDate

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

Tipo:DateTime
Posición:7
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Tipo:String
Posición:9
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ShowInGui

Indica que este cmdlet muestra la imagen en la GUI.

Tipo:SwitchParameter
Posición:12
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SmallIconName

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

Tipo:String
Alias:SmallIconUri
Posición:11
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

OSImageContext