Add-AzureDataDisk

  • Odwołanie
Moduł:
Azure

Dodaje dysk danych do maszyny wirtualnej.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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>]

Opis

Polecenie cmdlet Add-AzureDataDisk dodaje nowy lub istniejący dysk danych do obiektu maszyny wirtualnej platformy Azure. Użyj parametru CreateNew , aby utworzyć nowy dysk danych o określonym rozmiarze i etykiecie. Użyj parametru Importuj, aby dołączyć istniejący dysk z repozytorium obrazów. Użyj parametru ImportFrom , aby dołączyć istniejący dysk z obiektu blob na koncie magazynu. Możesz określić tryb pamięci podręcznej hosta dołączonego dysku danych.

Przykłady

Przykład 1. Importowanie dysku danych z repozytorium

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

To polecenie pobiera obiekt maszyny wirtualnej dla maszyny wirtualnej o nazwie VirtualMachine07 w usłudze w chmurze ContosoService przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje je do bieżącego polecenia cmdlet przy użyciu operatora potoku. To polecenie dołącza istniejący dysk danych z repozytorium do maszyny wirtualnej. Dysk danych ma numer LUN 0. Polecenie aktualizuje maszynę wirtualną w celu odzwierciedlenia zmian przy użyciu polecenia cmdlet Update-AzureVM .

Przykład 2. Dodawanie nowego dysku danych

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

To polecenie pobiera obiekt maszyny wirtualnej dla maszyny wirtualnej o nazwie VirtualMachine08. Polecenie przekazuje je do bieżącego polecenia cmdlet. To polecenie dołącza nowy dysk danych o nazwie MyNewDisk.vhd. Polecenie cmdlet tworzy dysk w kontenerze vhds na domyślnym koncie magazynu bieżącej subskrypcji. Polecenie aktualizuje maszynę wirtualną w celu odzwierciedlenia zmian.

Przykład 3. Dodawanie dysku danych z określonej lokalizacji

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

To polecenie pobiera obiekt maszyny wirtualnej dla maszyny wirtualnej o nazwie Database. Polecenie przekazuje je do bieżącego polecenia cmdlet. To polecenie dołącza istniejący dysk danych o nazwie Disk14.vhd z określonej lokalizacji. Polecenie aktualizuje maszynę wirtualną w celu odzwierciedlenia zmian.

Parametry

-CreateNew

Wskazuje, że to polecenie cmdlet tworzy dysk danych.

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

-DiskLabel

Określa etykietę dysku dla nowego dysku danych.

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

-DiskName

Określa nazwę dysku danych w repozytorium dysków.

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

-DiskSizeInGB

Określa rozmiar dysku logicznego w gigabajtach dla nowego dysku danych.

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

-HostCaching

Określa ustawienia buforowania na poziomie hosta dysku. Prawidłowe wartości to:

  • Brak
  • Tylko do odczytu
  • ReadWrite
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Import

Wskazuje, że to polecenie cmdlet importuje istniejący dysk danych z repozytorium obrazów.

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

-ImportFrom

Wskazuje, że to polecenie cmdlet importuje istniejący dysk danych z obiektu blob na koncie magazynu.

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

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

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

-LUN

Określa numer jednostki logicznej (LUN) dla dysku danych na maszynie wirtualnej. Prawidłowe wartości to: od 0 do 15. Każdy dysk danych musi mieć unikatową jednostkę LUN.

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

-MediaLocation

Określa lokalizację obiektu blob na koncie usługi Azure Storage, w którym to polecenie cmdlet przechowuje dysk danych. Jeśli nie określisz lokalizacji, polecenie cmdlet przechowuje dysk danych w kontenerze vhds w domyślnym koncie magazynu dla bieżącej subskrypcji. Jeśli kontener vhds nie istnieje, polecenie cmdlet tworzy kontener vhds.

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

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

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

-VM

Określa obiekt maszyny wirtualnej, do którego to polecenie cmdlet dołącza dysk danych. Aby uzyskać obiekt maszyny wirtualnej, użyj polecenia cmdlet Get-AzureVM .

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