Udostępnij za pośrednictwem

Add-AzVMDataDisk

  • Odwołanie
Moduł:
Az.Compute

Dodaje dysk danych do maszyny wirtualnej.

Składnia

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Add-AzVMDataDisk dodaje dysk danych do maszyny wirtualnej. Dysk danych można dodać podczas tworzenia maszyny wirtualnej lub dodać dysk danych do istniejącej maszyny wirtualnej.

Przykłady

Przykład 1. Dodawanie dysków danych do nowej maszyny wirtualnej

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

Pierwsze polecenie tworzy obiekt maszyny wirtualnej, a następnie przechowuje go w zmiennej $VirtualMachine. Polecenie przypisuje nazwę i rozmiar do maszyny wirtualnej. Następne trzy polecenia przypisują ścieżki trzech dysków danych do zmiennych $DataDiskVhdUri 01, $DataDiskVhdUri 02 i $DataDiskVhdUri 03. Takie podejście umożliwia tylko czytelność następujących poleceń. Ostatnie trzy polecenia dodaje dysk danych do maszyny wirtualnej przechowywanej w $VirtualMachine. Polecenie określa nazwę i lokalizację dysku oraz inne właściwości dysku. Identyfikator URI każdego dysku jest przechowywany w $DataDiskVhdUri 01, $DataDiskVhdUri 02 i $DataDiskVhdUri 03.

Przykład 2. Dodawanie dysku danych do istniejącej maszyny wirtualnej

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Pierwsze polecenie pobiera maszynę wirtualną o nazwie VirtualMachine07 przy użyciu polecenia cmdlet Get-AzVM . Polecenie przechowuje maszynę wirtualną w zmiennej $VirtualMachine. Drugie polecenie dodaje dysk danych do maszyny wirtualnej przechowywanej w $VirtualMachine. Ostatnie polecenie aktualizuje stan maszyny wirtualnej przechowywanej w $VirtualMachine w grupie ResourceGroup11.

Przykład 3. Dodawanie dysku danych do nowej maszyny wirtualnej z uogólnionego obrazu użytkownika

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

Pierwsze polecenie tworzy obiekt maszyny wirtualnej i przechowuje go w zmiennej $VirtualMachine. Polecenie przypisuje nazwę i rozmiar do maszyny wirtualnej. Dwa następne polecenia przypisują ścieżki dla obrazów danych i dysków danych do odpowiednio zmiennych $DataImageUri i $DataDiskUri. To podejście służy do poprawy czytelności następujących poleceń. Ostatnie polecenia dodają dysk danych do maszyny wirtualnej przechowywanej w $VirtualMachine. Polecenie określa nazwę i lokalizację dysku oraz inne właściwości dysku.

Przykład 4. Dodawanie dysków danych do nowej maszyny wirtualnej z wyspecjalizowanego obrazu użytkownika

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

Pierwsze polecenie tworzy obiekt maszyny wirtualnej i przechowuje go w zmiennej $VirtualMachine. Polecenie przypisuje nazwę i rozmiar do maszyny wirtualnej. Następne polecenia przypisuje ścieżki dysku danych do zmiennej $DataDiskUri. To podejście służy do poprawy czytelności następujących poleceń. Ostatnie polecenie dodaje dysk danych do maszyny wirtualnej przechowywanej w $VirtualMachine. Polecenie określa nazwę i lokalizację dysku oraz inne właściwości dysku.

Parametry

-Caching

Określa tryb buforowania dysku. Dopuszczalne wartości tego parametru to:

  • Tylko do odczytu
  • ReadWrite
  • Brak Wartość domyślna to ReadWrite. Zmiana tej wartości powoduje ponowne uruchomienie maszyny wirtualnej. To ustawienie wpływa na spójność i wydajność dysku.
Typ:CachingTypes
Dopuszczalne wartości:None, ReadOnly, ReadWrite
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CreateOption

Określa, czy to polecenie cmdlet tworzy dysk na maszynie wirtualnej na podstawie platformy lub obrazu użytkownika, tworzy pusty dysk lub dołącza istniejący dysk. Dopuszczalne wartości tego parametru to:

  • Przymocować. Określ tę opcję, aby utworzyć maszynę wirtualną na podstawie wyspecjalizowanego dysku. Po określeniu tej opcji nie należy określać parametru SourceImageUri . VhdUri to wszystko, co jest potrzebne, aby poinformować platformę Azure o lokalizacji wirtualnego dysku twardego (VHD) do dołączenia jako dysku danych do maszyny wirtualnej.
  • Pusty. Określ to, aby utworzyć pusty dysk danych.
  • FromImage. Określ tę opcję, aby utworzyć maszynę wirtualną na podstawie uogólnionego obrazu lub dysku. Po określeniu tej opcji należy określić parametr SourceImageUri również, aby poinformować platformę Azure o lokalizacji wirtualnego dysku twardego do dołączenia jako dysku danych. Parametr VhdUri jest używany jako lokalizacja identyfikująca, gdzie dysk VHD danych będzie przechowywany, gdy jest używany przez maszynę wirtualną.
  • Pusty. Ta wartość jest używana podczas tworzenia pustego dysku danych.
  • Kopiowanie. Ta wartość służy do tworzenia dysku danych na podstawie migawki lub innego dysku. Przywracanie: ta wartość służy do tworzenia dysku danych z punktu przywracania dysku.
Typ:String
Position:6
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DeleteOption

Opcja usuwania dysku danych. Określa, jaką akcję należy wykonać na dysku po usunięciu maszyny wirtualnej. Opcje to: Odłącz, Usuń.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskEncryptionSetId

Określa identyfikator zasobu zestawu szyfrowania dysków zarządzanych przez klienta. Można to określić tylko dla dysku zarządzanego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DiskSizeInGB

Określa rozmiar w gigabajtach pustego dysku, który ma zostać dołączony do maszyny wirtualnej.

Typ:Nullable<T>[Int32]
Position:4
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Lun

Określa numer jednostki logicznej (LUN) dla dysku danych.

Typ:Nullable<T>[Int32]
Position:5
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ManagedDiskId

Określa identyfikator dysku zarządzanego.

Typ:String
Position:8
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę dysku danych do dodania.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SourceImageUri

Określa źródłowy identyfikator URI dysku, który dołącza to polecenie cmdlet.

Typ:String
Aliasy:SourceImage
Position:7
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SourceResourceId

Identyfikator arm punktu przywracania migawki lub dysku, z którego ma zostać utworzony dysk.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountType

Określa typ konta magazynu dysku zarządzanego.

Typ:String
Position:9
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VhdUri

Określa identyfikator URI (Uniform Resource Identifier) dla pliku wirtualnego dysku twardego (VHD), który ma zostać utworzony podczas użycia obrazu platformy lub obrazu użytkownika. To polecenie cmdlet kopiuje obraz binarny duży obiekt (blob) do tej lokalizacji. Jest to lokalizacja, z której ma być uruchamiana maszyna wirtualna.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VM

Określa lokalny obiekt maszyny wirtualnej, do którego ma zostać dodany dysk danych. Aby uzyskać obiekt maszyny wirtualnej, możesz użyć polecenia cmdlet Get-AzVM . Aby utworzyć obiekt maszyny wirtualnej, możesz użyć polecenia cmdlet New-AzVMConfig .

Typ:PSVirtualMachine
Aliasy:VMProfile
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WriteAccelerator

Określa, czy funkcja WriteAccelerator powinna być włączona, czy wyłączona na dysku danych zarządzanych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSVirtualMachine

String

CachingTypes

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

Dane wyjściowe

PSVirtualMachine

PSVirtualMachineScaleSetVM