Share via

Set-AzureDataDisk

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

Azure 仮想マシン上の既存のデータ ディスクのホスト キャッシュを変更します。

注意

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

構文

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

説明

Set-AzureDataDisk コマンドレットは、Azure 仮想マシン上の既存のデータ ディスクのキャッシュ属性を変更します。 更新するデータ ディスクを論理ユニット番号 (LUN) で指定します。

例

例 1: データ ディスクのホスト キャッシュを変更する

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

このコマンドは、Get-AzureVM コマンドレットを使用して ContosoService という名前のサービスで実行される仮想マシンを取得します。 コマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 このコマンドレットは、VirtualMachine07 という名前の仮想マシンの LUN 2 にあるデータ ディスクを ReadOnly ホスト キャッシュを使用するように設定します。 このコマンドは、Update-AzureVM コマンドレットを使用して、変更を反映するように仮想マシンを更新します。

例 2: 仮想マシン上のすべてのデータ ディスクのホスト キャッシュを変更する

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

このコマンドは、ContosoService クラウド サービス上の VirtualMachine07 という名前の仮想マシンのオブジェクトを取得します。 このコマンドは、その仮想マシンの データ ディスクを取得する Get-AzureDataDisk コマンドレットに渡します。 次に、現在のコマンドレットは、各データ ディスクのホスト キャッシュ モードを ReadWrite に設定します。 このコマンドは、変更を反映するように仮想マシンを更新します。

パラメーター

-DiskName

このコマンドレットが変更するデータ ディスク構成の名前を指定します。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-HostCaching

警告

4 TiB 以上のディスクでは、ディスク キャッシュはサポートされていません。 複数のディスクが VM に接続されている場合、4 TiB 未満の各ディスクでは、キャッシュがサポートされます。

Azure ディスクのキャッシュ設定を変更すると、対象となるディスクをデタッチして再アタッチします。 オペレーティング システム ディスクの場合は、VM が再起動されます。 ディスク キャッシュの設定を変更する前に、この中断の影響を受ける可能性があるすべてのアプリケーションまたはサービスを停止します。 これらの推奨事項に従っていないと、データが破損する可能性があります。

ディスクのホスト レベルのキャッシュ設定を指定します。 有効な値は次のとおりです。

  • なし
  • 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

-LUN

仮想マシン内のデータ ドライブの LUN を指定します。 有効な値は 0 から 15 です。

Type:Int32
Position:1
Default value:None
Required:True
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:4
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