Compartir a través de

Remove-AzureVMImage

  • Referencia
Módulo:
Azure

Quita una imagen de sistema operativo del 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

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

Description

El cmdlet Remove-AzureVMImage quita una imagen de sistema operativo del repositorio de imágenes. De forma predeterminada, este cmdlet no elimina el blob de imagen física asociado de la cuenta de almacenamiento. Para eliminar el disco duro virtual asociado (VHD), use el parámetro DeleteVHD .

Ejemplos

Ejemplo 1: Quitar una imagen del repositorio de imágenes

PS C:\> Remove-AzureVMImage -ImageName "Image001"

Este comando quita la imagen denominada Image001 del repositorio de imágenes.

Ejemplo 2: Quitar una imagen del repositorio de imágenes y también el disco duro virtual

PS C:\> Remove-AzureVMImage -ImageName " Image001" -DeleteVHD

Este comando quita la imagen denominada Image001 del repositorio de imágenes y también elimina la imagen de disco duro virtual física de la cuenta de almacenamiento.

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

PS C:\> $SubsId = &lt;MySubscriptionID&gt;
PS C:\> $Cert = Get-AzureCertificate cert:\LocalMachine\MY\&lt;CertificateThumbprint&gt;
PS C:\> Get-AzureVMImage `
| Where-Object {$_.Label -match "Beta" }`
| Foreach-Object {Remove-AzureVMImage -ImageName $_.name }

Este comando establece el contexto de suscripción y, a continuación, quita todas las imágenes del repositorio de imágenes cuya etiqueta incluye el nombre Beta.

Parámetros

-DeleteVHD

Indica que este cmdlet elimina el blob de imagen de disco duro virtual físico de la cuenta de almacenamiento.

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

-ImageName

Especifica el sistema operativo o la imagen de máquina virtual que se va a quitar del 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

-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