Save-AzureVhd

  • Referencia
Módulo:
Azure

Habilita la descarga de imágenes .vhd.

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

Save-AzureVhd
    [-Source] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [[-StorageKey] <String>]
    [-OverWrite]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

Description

El cmdlet Save-AzureVhd permite descargar imágenes .vhd desde un blob donde se almacenan en un archivo. Tiene parámetros para configurar el proceso de descarga especificando el número de subprocesos del descargador que se usan o sobrescriben el archivo que ya existe en la ruta de acceso del archivo especificada.

Save-AzureVhd no realiza ninguna conversión de formato VHD y el blob se descarga tal y como está.

Ejemplos

Ejemplo 1: Descargar un archivo VHD

PS C:\> Save-AzureVhd -Source "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

Este comando descarga un archivo .vhd.

Ejemplo 2: Descargar un archivo VHD y sobrescribir el archivo local

PS C:\> Save-AzureVhd -Source "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

Este comando descarga un archivo .vhd y sobrescribe cualquier archivo de la ruta de acceso de destino.

Ejemplo 3: Descargar un archivo VHD y especificar el número de subprocesos

PS C:\> Save-AzureVhd -Source "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32

Este comando descarga un archivo .vhd y especifica el número de subprocesos.

Ejemplo 4: Descargar un archivo VHD y especificar la clave de almacenamiento

PS C:\> Save-AzureVhd -Source "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw=="

Este comando descarga un archivo .vhd y especifica la clave de almacenamiento.

Parámetros

-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

-LocalFilePath

Especifica la ruta de acceso del archivo local.

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

-NumberOfThreads

Especifica el número de subprocesos de descarga que usa este cmdlet durante la descarga.

Tipo:Int32
Alias:th
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OverWrite

Especifica que este cmdlet elimina el archivo especificado por el archivo LocalFilePath si existe.

Tipo:SwitchParameter
Alias:o
Posición:5
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

-Source

Especifica el identificador uniforme de recursos (URI) para el blob en Azure.

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

-StorageKey

Especifica la clave de almacenamiento de la cuenta de almacenamiento de blobs. Si no se proporciona, Save-AzureVhd intenta determinar la clave de almacenamiento de la cuenta en SourceUri desde Azure.

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