Freigeben über

Add-AzureDataDisk

  • Referenz
Modul:
Azure

Fügt einem virtuellen Computer einen Datenträger hinzu.

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

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Add-AzureDataDisk-Cmdlet fügt einem Virtuellen Azure-Computerobjekt einen neuen oder vorhandenen Datenträger hinzu. Verwenden Sie den Parameter CreateNew , um einen neuen Datenträger mit einer angegebenen Größe und Bezeichnung zu erstellen. Verwenden Sie den Parameter "Import ", um einen vorhandenen Datenträger aus dem Image-Repository anzufügen. Verwenden Sie den Parameter "ImportFrom ", um einen vorhandenen Datenträger aus einem Blob in einem Speicherkonto anzufügen. Sie können den Hostcachemodus des angefügten Datenträgers angeben.

Beispiele

Beispiel 1: Importieren eines Datenträgers aus dem Repository

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

Dieser Befehl ruft ein Objekt des virtuellen Computers für den virtuellen Computer mit dem Namen VirtualMachine07 im ContosoService-Clouddienst mithilfe des Cmdlets "Get-AzureVM " ab. Der Befehl übergibt ihn mithilfe des Pipelineoperators an das aktuelle Cmdlet. Dieser Befehl fügt einen vorhandenen Datenträger aus dem Repository an den virtuellen Computer an. Der Datenträger hat eine LUN von 0. Mit dem Befehl wird der virtuelle Computer aktualisiert, um Ihre Änderungen mithilfe des Cmdlets Update-AzureVM widerzuspiegeln.

Beispiel 2: Hinzufügen eines neuen Datenträgers

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

Dieser Befehl ruft ein Objekt des virtuellen Computers für den virtuellen Computer mit dem Namen VirtualMachine08 ab. Der Befehl übergibt ihn an das aktuelle Cmdlet. Dieser Befehl fügt einen neuen Datenträger namens "MyNewDisk.vhd" an. Das Cmdlet erstellt den Datenträger im vhds-Container im Standardspeicherkonto des aktuellen Abonnements. Der Befehl aktualisiert den virtuellen Computer, um Ihre Änderungen widerzuspiegeln.

Beispiel 3: Hinzufügen eines Datenträgers von einem angegebenen Speicherort

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

Dieser Befehl ruft ein Objekt des virtuellen Computers für den virtuellen Computer namens "Database" ab. Der Befehl übergibt ihn an das aktuelle Cmdlet. Dieser Befehl fügt einen vorhandenen Datenträger namens "Disk14.vhd" vom angegebenen Speicherort an. Der Befehl aktualisiert den virtuellen Computer, um Ihre Änderungen widerzuspiegeln.

Parameter

-CreateNew

Gibt an, dass dieses Cmdlet einen Datenträger erstellt.

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

-DiskLabel

Gibt die Datenträgerbezeichnung für einen neuen Datenträger an.

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

-DiskName

Gibt den Namen eines Datenträgers im Datenträger-Repository an.

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

-DiskSizeInGB

Gibt die logische Datenträgergröße in Gigabyte für einen neuen Datenträger an.

Typ:Int32
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HostCaching

Gibt die Einstellungen für die Zwischenspeicherung auf Hostebene des Datenträgers an. Gültige Werte sind:

  • Keine
  • ReadOnly
  • ReadWrite
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Import

Gibt an, dass dieses Cmdlet einen vorhandenen Datenträger aus dem Image-Repository importiert.

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

-ImportFrom

Gibt an, dass dieses Cmdlet einen vorhandenen Datenträger aus einem BLOB in einem Speicherkonto importiert.

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Weiter
  • 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

-LUN

Gibt die logische Einheitennummer (LUN) für das Datenlaufwerk auf dem virtuellen Computer an. Gültige Werte sind: 0 bis 15. Jeder Datenträger muss über eine eindeutige LUN verfügen.

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

-MediaLocation

Gibt den Speicherort des Blobs in einem Azure-Speicherkonto an, in dem dieses Cmdlet den Datenträger speichert. Wenn Sie keinen Speicherort angeben, speichert das Cmdlet den Datenträger im vhds-Container im Standardspeicherkonto für das aktuelle Abonnement. Wenn kein vhds-Container vorhanden ist, erstellt das Cmdlet einen vhds-Container.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-VM

Gibt das Objekt des virtuellen Computers an, dem dieses Cmdlet einen Datenträger anfügt. Verwenden Sie das Cmdlet "Get-AzureVM ", um ein Objekt eines virtuellen Computers abzurufen.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False