Compartir a través de

Get-AzureVMImage

  • Referencia
Módulo:
Azure

Obtiene las propiedades de uno o una lista de sistemas operativos o una imagen de máquina virtual 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

Get-AzureVMImage
   [[-ImageName] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureVMImage obtiene propiedades de uno o una lista de sistemas operativos o una imagen de máquina virtual en el repositorio de imágenes. El cmdlet devuelve información para todas las imágenes del repositorio o sobre una imagen específica si se proporciona su nombre de imagen.

Ejemplos

Ejemplo 1: Obtener un objeto de imagen específico del repositorio de imágenes actual.

PS C:\> Get-AzureVMImage -ImageName Image001

Este comando obtiene el objeto de imagen denominado Image001 del repositorio de imágenes actual.

Ejemplo 2: Obtención de todas las imágenes del repositorio de imágenes actual

PS C:\> Get-AzureVMImage

Este comando recupera todas las imágenes del repositorio de imágenes actual.

Ejemplo 3: Establecer el contexto de suscripción y, a continuación, obtener todas las imágenes

PS C:\> $SubsId = <MySubscriptionID>
C:\PS>$Cert = Get-AzureCertificate cert:\LocalMachine\MY\<CertificateThumbprint>
C:\PS>$MyOSImages = Get-AzureVMImage

Este comando establece el contexto de suscripción y, a continuación, recupera todas las imágenes del repositorio de imágenes.

Parámetros

-ImageName

Especifica el nombre del sistema operativo o la imagen de máquina virtual en el repositorio de imágenes. Si no especifica este parámetro, se devuelven todas las imágenes.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:False
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

-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