Add-AzVhd

  • Referenz
Modul:
Az.Compute

Lädt eine virtuelle Festplatte von einem lokalen Computer auf Azure hoch (verwalteter Datenträger oder Blob).

Syntax

Add-AzVhd
   [-ResourceGroupName] <String>
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-SkipResizing]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVhd
   [-ResourceGroupName] <String>
   [-LocalFilePath] <FileInfo>
   -DiskName <String>
   [-Location] <String>
   [-DiskSku <String>]
   [-DiskZone <String[]>]
   [-DiskHyperVGeneration <String>]
   [-DiskOsType <OperatingSystemTypes>]
   [[-NumberOfUploaderThreads] <Int32>]
   [-DataAccessAuthMode <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzVhd-Cmdlet lädt eine lokale virtuelle Festplatte auf einen verwalteten Datenträger oder ein Blob-Speicherkonto hoch.

Die virtuelle Festplatte, die hochgeladen wird, muss eine VHD-Datei und größe N * Mib + 512 Bytes sein. Mithilfe der Hyper-V-Funktionalität konvertiert Add-AzVhd alle VHDX-Dateien in eine VHD-Datei und ändern die Größe vor dem Hochladen. Um diese Funktionalität zuzulassen , müssen Sie Hyper-V aktivieren. Wenn Sie einen Linux-Computer verwenden oder diese Funktionalität nicht verwenden möchten, müssen Sie die Größe der VHD-Datei manuell ändern. Darüber hinaus wandelt Add-AzVhd während des Uploads dynamisch angepasste VHD-Dateien in feste Größe um. Wird verwendet -Verbose , um den gesamten Prozess zu verfolgen.

Für den Standardparametersatz (Upload in Blob) wird auch 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.

Für den Parameter "Direct Upload to Managed Disk Parameter" werden Parameter: ResourceGroupName, DiskName, Location, DiskSku und Zone verwendet, um einen neuen Datenträger zu erstellen. Anschließend wird die virtuelle Festplatte in ihn hochgeladen.

Weitere Informationen zur Verwendung von Add-AzVhd zum direkten Hochladen auf einen verwalteten Datenträger.

Für VHD-Dateien mit mehr als 50 GB empfehlen wir die Verwendung von AzCopy für einen schnelleren Upload.

Beispiele

Beispiel 1: Hinzufügen einer VHD-Datei zu einem Blob

Add-AzVhd -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 zu einem Blob und Überschreiben des Ziels

Add-AzVhd -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 zu einem Blob mit der angegebenen Anzahl von Threads

Add-AzVhd -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 zu einem Blob und Angeben des SAS-URI

Add-AzVhd -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.

Beispiel 5: Direktes Hinzufügen einer VHD-Datei zu einem verwalteten Datenträger.

Add-AzVhd -LocalFilePath C:\data.vhd -ResourceGroupName rgname -Location eastus -DiskName newDisk

Mit diesem Befehl wird ein verwalteter Datenträger mit dem angegebenen ResourceGroupName, Location und DiskName erstellt. und lädt die VHD-Datei in die Datei hoch.

Beispiel 6: Direktes Hinzufügen einer VHD-Datei zu einem konfigurierten Datenträger.

Add-AzVhd -LocalFilePath C:\Data.vhdx -ResourceGroupName rgname -Location eastus -DiskName newDisk -Zone 1 -DiskSku Premium_LRS

Dieser Befehl versucht, vhdx-Datei zuerst mithilfe von Hyper-V in vhd-Datei zu konvertieren. Wenn Hyper-V nicht gefunden wird, wird ein Fehler zurückgegeben, der aufgefordert wird, eine vhd-Datei zu verwenden. Nach erfolgreicher Konvertierung wird ein verwalteter Datenträger mit bereitgestellten Parametern erstellt und dann die vhd-Datei hochgeladen.

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

-DataAccessAuthMode

Zusätzliche Authentifizierungsanforderungen beim Exportieren oder Hochladen auf einen Datenträger oder eine Momentaufnahme. Mögliche Optionen sind: "AzureActiveDirectory" und "None".

Typ:String
Position:Named
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:AzContext, 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

-DiskHyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. Mögliche Werte sind: 'V1', 'V2'.

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

-DiskName

Name des neuen verwalteten Datenträgers

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

-DiskOsType

Der Betriebssystemtyp des verwalteten Datenträgers. Mögliche Werte sind: 'Windows', 'Linux'.

Typ:OperatingSystemTypes
Aliase:OsType
Zulässige Werte:Windows, Linux
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DiskSku

Sku für verwalteten Datenträger. Optionen: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

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

-DiskZone

Die Liste der logischen Zonen für den Datenträger.

Typ:String[]
Aliase:Zone
Position:Named
Standardwert:None
Erforderlich:False
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

-Location

Speicherort des neuen verwalteten Datenträgers

Typ:String
Position:1
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:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SkipResizing

Überspringt die Größenänderung der VHD-Datei. Benutzer, die eine VHD-Dateien hochladen möchten, die ihre Größe falsch ausgerichtet haben (nicht N * Mib + 512 Bytes) in ein BLOB können diesen Switch-Parameter verwenden.

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

Eingaben

String

Uri

FileInfo

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

SwitchParameter

Ausgaben

VhdUploadContext