Udostępnij za pośrednictwem

Set-AzureOSDisk

  • Odwołanie
Moduł:
Azure

Modyfikuje tryb pamięci podręcznej hosta maszyny 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-AzureOSDisk
   [-HostCaching] <String>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureOSDisk
   [[-HostCaching] <String>]
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureOSDisk modyfikuje tryb pamięci podręcznej hosta dysku systemu operacyjnego maszyny wirtualnej platformy Azure. Obsługiwane tryby pamięci podręcznej hostów to ReadOnly i ReadWrite. Jeśli uruchomisz to polecenie cmdlet na uruchomionej maszynie wirtualnej, ta maszyna wirtualna zostanie uruchomiona ponownie.

Przykłady

Przykład 1. Ustawienie trybu pamięci podręcznej hosta na Wartość ReadOnly przy użyciu potoku

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02" | Set-AzureOSDisk -HostCaching "ReadOnly"

To polecenie pobiera maszynę wirtualną o nazwie VirtualMachine02 w usłudze o nazwie ContosoService przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje maszynę wirtualną do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet ustawia tryb pamięci podręcznej hosta dysku systemu operacyjnego tej maszyny wirtualnej na wartość ReadOnly.

Przykład 2. Ustawianie trybu pamięci podręcznej hosta na Wartość ReadWrite

PS C:\> $VM = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02"
PS C:\> Set-AzureOSDisk "ReadWrite" -VM $myVM2

Pierwsze polecenie pobiera maszynę wirtualną o nazwie VirtualMachine02 w usłudze o nazwie ContosoService, a następnie zapisuje ją w zmiennej.

Drugie polecenie ustawia tryb pamięci podręcznej hosta dysku systemu operacyjnego tej maszyny wirtualnej na wartość ReadWrite.

Parametry

-HostCaching

Określa atrybut pamięci podręcznej hosta dla dysku systemu operacyjnego. Prawidłowe wartości to:

  • 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

-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 systemu operacyjnego. Rozmiar musi być większy niż bieżący rozmiar.

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

-VM

Określa maszynę wirtualną, dla której to polecenie cmdlet modyfikuje dysk systemu operacyjnego. 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