Freigeben über


Save-AzureRmVhd

Speichert heruntergeladene VHD-Bilder lokal.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Save-AzureRmVhd
    [-ResourceGroupName] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzureRmVhd
    [-StorageKey] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Save-AzureRmVhd speichert VHD-Bilder aus einem Blob, in dem sie in einer Datei gespeichert sind. Sie können die Anzahl der von dem Prozess verwendeten Downloaderthreads angeben und angeben, ob eine datei ersetzt werden soll, die bereits vorhanden ist. Dieses Cmdlet lädt Inhalte wie folgt herunter. Es wird keine VHD-Formatkonvertierung (Virtual Hard Disk) angewendet.

Beispiele

Beispiel 1: Herunterladen eines Bilds

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"

Dieser Befehl lädt eine VHD-Datei herunter und speichert sie im lokalen Pfad C:\vhd\Win7Image.vhd.

Beispiel 2: Herunterladen eines Bilds und Überschreiben der lokalen Datei

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite -ResourceGroupName "rgname"

Dieser Befehl lädt eine VHD-Datei herunter und speichert sie im lokalen Pfad. Der Befehl enthält den Parameter Overwrite . Wenn C:\vhd\Win7Image.vhd bereits vorhanden ist, ersetzt dieser Befehl ihn daher.

Beispiel 3: Herunterladen eines Bilds mithilfe einer angegebenen Anzahl von Threads

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"

Dieser Befehl lädt eine VHD-Datei herunter und speichert sie im lokalen Pfad. Der Befehl gibt einen Wert von 32 für den Parameter NumberOfThreads an. Daher verwendet das Cmdlet 32 Threads für diese Aktion.

Beispiel 4: Herunterladen eines Bilds und Angeben des Speicherschlüssels

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

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

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus, und geben Sie einen Auftrag zurück, um den Fortschritt nachzuverfolgen.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LocalFilePath

Gibt den lokalen Dateipfad des gespeicherten Bilds 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 ersetzt, falls vorhanden.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des Speicherkontos an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SourceUri

Gibt den URI (Uniform Resource Identifier) des Blobs an Azure.

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

-StorageKey

Gibt den Speicherschlüssel des BLOB-Speicherkontos an. Wenn Sie keinen Schlüssel angeben, versucht dieses Cmdlet, den Speicherschlüssel des Kontos in SourceUri aus Azure zu ermitteln.

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

Eingaben

String

Uri

Ausgaben

VhdDownloadContext