Add-AzVMDataDisk
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>]
[-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>]
[-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 EmptyPierwsze 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 $VirtualMachinePierwsze 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 FromImagePierwsze 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 AttachPierwsze 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.
| Type: | CachingTypes |
| Accepted values: | None, ReadOnly, ReadWrite |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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:
- Dołączyć. 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ą.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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ń.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskEncryptionSetId
Określa identyfikator zasobu zestawu szyfrowania dysków zarządzanych przez klienta. Można to określić tylko dla dysku zarządzanego.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSizeInGB
Określa rozmiar w gigabajtach pustego dysku, który ma zostać dołączony do maszyny wirtualnej.
| Type: | Nullable<T>[Int32] |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Lun
Określa numer jednostki logicznej (LUN) dla dysku danych.
| Type: | Nullable<T>[Int32] |
| Position: | 5 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagedDiskId
Określa identyfikator dysku zarządzanego.
| Type: | String |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Określa nazwę dysku danych do dodania.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceImageUri
Określa źródłowy identyfikator URI dysku, który dołącza to polecenie cmdlet.
| Type: | String |
| Aliases: | SourceImage |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountType
Określa typ konta magazynu dysku zarządzanego.
| Type: | String |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 .
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WriteAccelerator
Określa, czy funkcja WriteAccelerator powinna być włączona, czy wyłączona na dysku danych zarządzanych.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wejściowe
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Dane wyjściowe
Linki powiązane
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla