Set-AzureDataDisk
Azure 仮想マシン上の既存のデータ ディスクのホスト キャッシュを変更します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される 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
このコマンドレットが変更するデータ ディスク構成の名前を指定します。
| 型: | String |
| 配置: | 3 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-HostCaching
警告
4 TiB 以上のディスクでは、ディスク キャッシュはサポートされていません。 複数のディスクが VM に接続されている場合、4 TiB 未満の各ディスクでは、キャッシュがサポートされます。
Azure ディスクのキャッシュ設定を変更すると、対象となるディスクをデタッチして再アタッチします。 オペレーティング システム ディスクの場合は、VM が再起動されます。 ディスク キャッシュの設定を変更する前に、この中断の影響を受ける可能性があるすべてのアプリケーションまたはサービスを停止します。 これらの推奨事項に従っていないと、データが破損する可能性があります。
ディスクのホスト レベルのキャッシュ設定を指定します。 有効な値は次の通りです。
- なし
- ReadOnly
- ReadWrite
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- [中断]
| 型: | ActionPreference |
| Aliases: | infa |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
| 型: | String |
| Aliases: | iv |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LUN
仮想マシン内のデータ ドライブの LUN を指定します。 有効な値は 0 から 15 です。
| 型: | Int32 |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| 型: | AzureSMProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ResizedSizeInGB
データ ディスクの新しいサイズをギガバイト単位で指定します。 新しいサイズは、現在のサイズより大きくする必要があります。
| 型: | Int32 |
| 配置: | 4 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VM
データ ディスクに接続されている仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureVM コマンドレットを使用します。
| 型: | IPersistentVM |
| Aliases: | InputObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |