Udostępnij za pośrednictwem

Set-AzureDataDisk

  • Odwołanie
Moduł:
Azure

Modyfikuje buforowanie hosta istniejącego dysku danych na maszynie wirtualnej platformy Azure.

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

Set-AzureDataDisk
   [-HostCaching] <String>
   [-LUN] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureDataDisk
   [-DiskName] <String>
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureDataDisk modyfikuje atrybuty pamięci podręcznej istniejącego dysku danych na maszynie wirtualnej platformy Azure. Określ dysk danych do zaktualizowania według numeru jednostki logicznej (LUN).

Przykłady

Przykład 1. Modyfikowanie buforowania hosta dla dysku danych

PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM

To polecenie pobiera maszyny wirtualne uruchamiane w usłudze o nazwie ContosoService przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje je do bieżącego polecenia cmdlet przy użyciu operatora potoku. To polecenie cmdlet ustawia dysk danych na numer LUN 2 maszyny wirtualnej o nazwie VirtualMachine07 do używania buforowania hostów ReadOnly. Polecenie aktualizuje maszynę wirtualną w celu odzwierciedlenia zmian przy użyciu polecenia cmdlet Update-AzureVM .

Przykład 2. Modyfikowanie buforowania hosta dla wszystkich dysków danych na maszynie wirtualnej

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM

To polecenie pobiera obiekt dla maszyny wirtualnej o nazwie VirtualMachine07 w usłudze w chmurze ContosoService. Polecenie przekazuje je do polecenia cmdlet Get-AzureDataDisk , które pobiera dyski danych dla tej maszyny wirtualnej. Bieżące polecenie cmdlet ustawia następnie tryb buforowania hosta dla poszczególnych dysków danych na Wartość ReadWrite. Polecenie aktualizuje maszynę wirtualną w celu odzwierciedlenia zmian.

Parametry

-DiskName

Określa nazwę konfiguracji dysku danych, którą modyfikuje to polecenie cmdlet.

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

-HostCaching

Ostrzeżenie

Buforowanie dysków nie jest dostępne dla dysków o pojemności 4 TiB i większych. Jeśli do maszyny wirtualnej jest dołączonych wiele dysków, każdy dysk mniejszy niż 4 TiB będzie obsługiwać buforowanie.

Zmienianie ustawień pamięci podręcznej dysku platformy Azure powoduje odłączenie i ponowne dołączenie dysku docelowego. Jeśli jest to dysk systemu operacyjnego, maszyna wirtualna zostanie ponownie uruchomiona. Zatrzymaj wszystkie aplikacje/usługi, na które może mieć wpływ to zakłócenie, przed zmianą ustawień pamięci podręcznej dysku. Nie przestrzegać tych zaleceń może prowadzić do uszkodzenia danych.

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

  • Brak
  • Tylko do odczytu
  • ReadWrite
Typ:String
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 LUN dla dysku danych na maszynie wirtualnej. Prawidłowe wartości to: od 0 do 15.

Typ:Int32
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
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

-ResizedSizeInGB

Określa nowy rozmiar w gigabajtach dla dysku danych. Nowy rozmiar musi być większy niż bieżący rozmiar.

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

-VM

Określa obiekt maszyny wirtualnej dołączony do dysku 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