Compartir a través de

Update-AzureVMImage

  • Referencia
Módulo:
Azure

Actualiza la etiqueta de una imagen de sistema operativo en el 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 las API de Azure Service Management (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 de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet Update-AzureVMImage actualiza la etiqueta en una imagen de sistema operativo en el repositorio de imágenes. Devuelve un objeto de imagen con información sobre la imagen actualizada.

Ejemplos

Ejemplo 1: Actualización de una imagen cambiando la etiqueta de imagen

PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"

Este comando actualiza la imagen denominada Windows-Server-2008-SP2 cambiando la etiqueta de imagen a DoNotUse.

Ejemplo 2: Obtener todos los sistemas operativos por etiqueta y, a continuación, actualizar la etiqueta

PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"

Este comando obtiene todas las imágenes del sistema operativo etiquetadas como DoNotUse y cambia la etiqueta a Actualizado.

Parámetros

-Description

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

Tipo:String
Posición:3
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 y del disco de datos para la imagen de máquina virtual creada mediante los cmdlets New-AzureVMImageDiskConfig, Set-AzureVMImageOSDiskConfig y Set-AzureVMImageDataDiskConfig.

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

-DontShowInGui

Indica que este cmdlet no 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

-Eula

Especifica el Contrato de licencia de usuario final. Se recomienda que el valor sea una dirección URL.

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

-IconName

Especifica el nombre del icono estándar para el sistema operativo o la imagen de máquina virtual.

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 puede usar para agrupar imágenes de sistema operativo o máquina virtual.

Tipo:String
Posición:4
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 actualizar en el 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
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • 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 la nueva etiqueta de la imagen.

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

-Language

Especifica el idioma del sistema operativo en la máquina virtual o la imagen del sistema operativo.

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

-PrivacyUri

Especifica el URI que apunta a un documento que contiene la directiva de privacidad relacionada con la imagen del sistema operativo.

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

-RecommendedVMSize

Especifica el tamaño de la máquina virtual.

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

  • Media
  • grande
  • ExtraLarge
  • A5
  • A6
  • A7
Tipo:String
Posición:7
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SmallIconName

Especifica el nombre de icono pequeño para el sistema operativo o la imagen de máquina virtual.

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