Share via

Set-AzureOSDisk

  • リファレンス
モジュール:
Azure

Azure 仮想マシンのホスト キャッシュ モードを変更します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

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

説明

Set-AzureOSDisk コマンドレットは、Azure 仮想マシンのオペレーティング システム ディスクのホスト キャッシュ モードを変更します。 サポートされているホスト キャッシュ モードは、ReadOnly と ReadWrite です。 実行中の仮想マシンでこのコマンドレットを実行すると、その仮想マシンが再起動します。

例

例 1: パイプラインを使用してホスト キャッシュ モードを ReadOnly に設定する

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

このコマンドは、Get-AzureVM コマンドレットを使用して、ContosoService という名前のサービス内の VirtualMachine02 という名前の仮想マシンを取得します。 このコマンドは、パイプライン 演算子を使用して、仮想マシンを現在のコマンドレットに渡します。 現在のコマンドレットは、その仮想マシンのオペレーティング システム ディスクのホスト キャッシュ モードを ReadOnly に設定します。

例 2: ホスト キャッシュ モードを ReadWrite に設定する

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

最初のコマンドは、ContosoService という名前のサービスで VirtualMachine02 という名前の仮想マシンを取得し、それを変数に格納します。

2 番目のコマンドは、その仮想マシンのオペレーティング システム ディスクのホスト キャッシュ モードを ReadWrite に設定します。

パラメーター

-HostCaching

オペレーティング システム ディスクのホスト キャッシュ属性を指定します。 有効な値は次のとおりです。

  • ReadOnly
  • ReadWrite
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResizedSizeInGB

オペレーティング システム ディスクの新しいサイズをギガバイト単位で指定します。 サイズは現在のサイズより大きくする必要があります。

Type:Int32
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

このコマンドレットがオペレーティング システム ディスクを変更する仮想マシンを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureVM コマンドレットを使用します。

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False