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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskLabel

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

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskName

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskSizeInGB

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

Type:	Int32
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-HostCaching

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

Keine
ReadOnly
ReadWrite

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Import

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

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImportFrom

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

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

Fortfahren
Ignorieren
Fragen
SilentlyContinue
Beenden
Angehalten

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Gibt eine Informationsvariable an.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False