Freigeben über


Save-AzureVhd

Aktiviert den Download von VHD-Bildern.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Save-AzureVhd ermöglicht das Herunterladen von VHD-Bildern aus einem BLOB, in dem sie in einer Datei gespeichert sind. Er verfügt über Parameter zum Konfigurieren des Downloadprozesses, indem die Anzahl der Downloadthreads angegeben wird, die verwendet oder überschrieben werden, die bereits im angegebenen Dateipfad vorhanden sind.

Save-AzureVhd führt keine VHD-Formatkonvertierung durch, und das Blob wird wie folgt heruntergeladen.

Beispiele

Beispiel 1: Herunterladen einer VHD-Datei

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

Dieser Befehl lädt eine VHD-Datei herunter.

Beispiel 2: Herunterladen einer VHD-Datei und Überschreiben der lokalen Datei

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

Mit diesem Befehl wird eine VHD-Datei heruntergeladen und jede Datei im Zielpfad überschrieben.

Beispiel 3: Herunterladen einer VHD-Datei und Angeben der Anzahl von Threads

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

Dieser Befehl lädt eine VHD-Datei herunter und gibt die Anzahl der Threads an.

Beispiel 4: Herunterladen einer VHD-Datei und Angeben des Speicherschlüssels

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

Dieser Befehl lädt eine VHD-Datei herunter und gibt den Speicherschlüssel an.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LocalFilePath

Gibt den lokalen Dateipfad an.

Typ:FileInfo
Aliase:lf
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NumberOfThreads

Gibt die Anzahl der Downloadthreads an, die dieses Cmdlet während des Downloads verwendet.

Typ:Int32
Aliase:th
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OverWrite

Gibt an, dass dieses Cmdlet die durch die LocalFilePath-Datei angegebene Datei löscht, falls vorhanden.

Typ:SwitchParameter
Aliase:o
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Source

Gibt den URI (Uniform Resource Identifier) für das Blob an Azure.

Typ:Uri
Aliase:src
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageKey

Gibt den Speicherschlüssel des BLOB-Speicherkontos an. Wenn sie nicht bereitgestellt wird, versucht Save-AzureVhd, den Speicherschlüssel des Kontos in SourceUri aus Azure zu ermitteln.

Typ:String
Aliase:sk
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False