Set-AzVMDataDisk
仮想マシン データ ディスクのプロパティを変更します。
構文
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <StorageAccountTypes>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Lun] <Int32>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <StorageAccountTypes>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Set-AzVMDataDisk コマンドレットは、仮想マシン データ ディスクのプロパティを変更します。
例
例 1: データ ディスクのキャッシュ モードを変更する
PS C:\> $VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
PS C:\> Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM
最初のコマンドは、Get-AzVM を使用して ContosoVM07 という名前の仮想マシンを取得します。 コマンドは、$VM変数に格納します。
2 番目のコマンドは、$VMの仮想マシン上の DataDisk01 という名前のデータ ディスクのキャッシュ モードを変更します。 このコマンドは、変更を実装する Update-AzVM コマンドレットに結果を渡します。 キャッシュ モードを変更すると、仮想マシンが再起動します。
パラメーター
-Caching
ディスクのキャッシュ モードを指定します。 このパラメーターの有効値は、次のとおりです。
- ReadOnly
- ReadWrite
既定値は ReadWrite です。 この値を変更すると、仮想マシンが再起動します。
この設定は、ディスクの整合性とパフォーマンスに影響します。
型: | CachingTypes |
承認された値: | None, ReadOnly, ReadWrite |
Position: | 2 |
既定値: | None |
必須: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
既定値: | None |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSizeInGB
データ ディスクのサイズをギガバイト単位で指定します。
型: | Int32 |
Position: | 3 |
既定値: | None |
必須: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Lun
このコマンドレットが変更するデータ ディスクの論理ユニット番号 (LUN) を指定します。
型: | Int32 |
Position: | 1 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
このコマンドレットが変更するデータ ディスクの名前を指定します。
型: | String |
Position: | 1 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountType
仮想マシンのマネージド ディスクのアカウントの種類。
型: | StorageAccountTypes |
承認された値: | StandardLRS, PremiumLRS |
Position: | Named |
既定値: | None |
必須: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
このコマンドレットがデータ ディスクを変更する仮想マシンを指定します。 仮想マシン オブジェクトを取得するには、Get-AzVM コマンドレットを使用します。
型: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WriteAccelerator
データ ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。
型: | SwitchParameter |
Position: | Named |
既定値: | None |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
PSVirtualMachine
パラメーター 'VM' は、パイプラインから 'PSVirtualMachine' 型の値を受け取ります