Set-AzVMDataDisk
仮想マシン データ ディスクのプロパティを変更します。
構文
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Lun] <Int32>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Set-AzVMDataDisk コマンドレットは、仮想マシン データ ディスクのプロパティを変更します。
例
例 1: データ ディスクのキャッシュ モードを変更する
$VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM
最初のコマンドは、 Get-AzVM を使用して ContosoVM07 という名前の仮想マシンを取得します。 コマンドは、$VM変数に格納します。 2 番目のコマンドは、$VMの仮想マシン上の DataDisk01 という名前のデータ ディスクのキャッシュ モードを変更します。 このコマンドは、変更を実装する Update-AzVM コマンドレットに結果を渡します。 キャッシュ モードを変更すると、仮想マシンが再起動します。
例 2
仮想マシン データ ディスクのプロパティを変更します。 (自動生成)
Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>
パラメーター
-Caching
ディスクのキャッシュ モードを指定します。 このパラメーターの有効値は、次のとおりです。
- ReadOnly
- ReadWrite 既定値は ReadWrite です。 この値を変更すると、仮想マシンが再起動します。 この設定は、ディスクの整合性とパフォーマンスに影響します。
型: | Nullable<T>[CachingTypes] |
指定可能な値: | None, ReadOnly, ReadWrite |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DiskEncryptionSetId
カスタマー マネージド ディスク暗号化セットのリソース ID を指定します。 これは、マネージド ディスクに対してのみ指定できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DiskSizeInGB
データ ディスクのサイズをギガバイト単位で指定します。
型: | Nullable<T>[Int32] |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Lun
このコマンドレットが変更するデータ ディスクの論理ユニット番号 (LUN) を指定します。
型: | Nullable<T>[Int32] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
このコマンドレットが変更するデータ ディスクの名前を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StorageAccountType
仮想マシンのマネージド ディスクのアカウントの種類。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VM
このコマンドレットがデータ ディスクを変更する仮想マシンを指定します。 仮想マシン オブジェクトを取得するには、Get-AzVM コマンドレットを使用します。
型: | PSVirtualMachine |
Aliases: | VMProfile |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WriteAccelerator
データ ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
出力
関連リンク
Azure PowerShell