Freigeben über


Add-AzureRMVhd

Lädt eine virtuelle Festplatte von einem lokalen virtuellen Computer zu einem Blob in einem Cloudspeicherkonto in Azure hoch

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

Add-AzureRMVhd
   [[-ResourceGroupName] <String>]
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzureRmVhd-Cmdlet lädt lokale virtuelle Festplatten im VHD-Dateiformat in ein BLOB-Speicherkonto als feste virtuelle Festplatten hoch. Sie können die Anzahl der Uploaderthreads konfigurieren, die verwendet oder ein vorhandenes Blob im angegebenen Ziel-URI überschrieben werden. Außerdem wird die Möglichkeit unterstützt, eine gepatchte Version einer lokalen VHD-Datei hochzuladen. Wenn eine virtuelle Basisfestplatte bereits hochgeladen wurde, können Sie unterschiedliche Datenträger hochladen, die das Basisimage als übergeordnetes Element verwenden. Der SAS-URI (Shared Access Signature) wird ebenfalls unterstützt.

Beispiele

Beispiel 1: Hinzufügen einer VHD-Datei

PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

Mit diesem Befehl wird einem Speicherkonto eine VHD-Datei hinzugefügt.

Beispiel 2: Hinzufügen einer VHD-Datei und Überschreiben des Ziels

PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

Mit diesem Befehl wird einem Speicherkonto eine VHD-Datei hinzugefügt. Der Befehl überschreibt eine vorhandene Datei.

Beispiel 3: Hinzufügen einer VHD-Datei und Angeben der Anzahl von Threads

PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfUploaderThreads 32

Mit diesem Befehl wird einem Speicherkonto eine VHD-Datei hinzugefügt. Der Befehl gibt die Anzahl der Threads an, die zum Hochladen der Datei verwendet werden sollen.

Beispiel 4: Hinzufügen einer VHD-Datei und Angeben des SAS-URI

PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd?st=2013-01 -09T22%3A15%3A49Z&se=2013-01-09T23%3A10%3A49Z&sr=b&sp=w&sig=13T9Ow%2FRJAMmhfO%2FaP3HhKKJ6AY093SmveO SIV4%2FR7w%3D" -LocalFilePath "C:\vhd\win7baseimage.vhd"

Mit diesem Befehl wird einem Speicherkonto eine VHD-Datei hinzugefügt und der SAS-URI angegeben.

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

-BaseImageUriToPatch

Gibt den URI für ein Basisimage-Blob in Azure Blob Storage an. Ein SAS kann als Wert für diesen Parameter angegeben werden.

Typ:Uri
Aliase:bs
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-Destination

Gibt den URI eines Blobs in Blob Storage an. Der Parameter unterstützt SAS-URI, obwohl Patchingszenarien kein SAS-URI sein können.

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

-LocalFilePath

Gibt den Pfad der lokalen VHD-Datei an.

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

-NumberOfUploaderThreads

Gibt die Anzahl der Uploaderthreads an, die beim Hochladen der VHD-Datei verwendet werden sollen.

Typ:Nullable<T>[Int32]
Aliase:th
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OverWrite

Gibt an, dass dieses Cmdlet ein vorhandenes BLOB im angegebenen Ziel-URI überschreibt, sofern vorhanden.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

Eingaben

String

Uri

FileInfo

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

SwitchParameter

Ausgaben

VhdUploadContext