Udostępnij za pośrednictwem

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
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-DiskLabel

Określa etykietę dysku dla nowego dysku danych.

Typ:String
Position:2
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-DiskName

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

Typ:String
Position:1
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskSizeInGB

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

Typ:Int32
Position:1
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-HostCaching

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

  • Brak
  • Tylko do odczytu
  • ReadWrite
Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Import

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

Typ:SwitchParameter
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-ImportFrom

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

Typ:SwitchParameter
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:infa
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliases:iv
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters: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
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters: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
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:InputObject
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False