Set-AzVMDataDisk
仮想マシン データ ディスクのプロパティを変更します。
構文
ChangeWithName
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ChangeWithLun
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
仮想マシン データ ディスクのプロパティを変更します。 (autogenerated)
Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>
パラメーター
-Caching
ディスクのキャッシュ モードを指定します。
このパラメーターに使用できる値は次のとおりです。
- ReadOnly
- ReadWrite 既定値は ReadWrite です。
この値を変更すると、仮想マシンが再起動します。
この設定は、ディスクの整合性とパフォーマンスに影響します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiskEncryptionSetId
カスタマー マネージド ディスク暗号化セットのリソース ID を指定します。 これは、マネージド ディスクに対してのみ指定できます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DiskSizeInGB
データ ディスクのサイズをギガバイト単位で指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Lun
このコマンドレットが変更するデータ ディスクの論理ユニット番号 (LUN) を指定します。
パラメーターのプロパティ
パラメーター セット
ChangeWithLun
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
このコマンドレットが変更するデータ ディスクの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ChangeWithName
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-StorageAccountType
仮想マシンのマネージド ディスクのアカウントの種類。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-VM
このコマンドレットがデータ ディスクを変更する仮想マシンを指定します。
仮想マシン オブジェクトを取得するには、Get-AzVM コマンドレットを使用します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WriteAccelerator
データ ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
