Set-AzVMDataDisk

モジュール:

Az.Compute

仮想マシン データ ディスクのプロパティを変更します。

構文

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 です。 この値を変更すると、仮想マシンが再起動します。 この設定は、ディスクの整合性とパフォーマンスに影響します。

Type:	Nullable<T>[CachingTypes]
Accepted values:	None, ReadOnly, ReadWrite
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskEncryptionSetId

カスタマー マネージド ディスク暗号化セットのリソース ID を指定します。 これは、マネージド ディスクに対してのみ指定できます。

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

-DiskSizeInGB

データ ディスクのサイズをギガバイト単位で指定します。

Type:	Nullable<T>[Int32]
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Lun

このコマンドレットが変更するデータ ディスクの論理ユニット番号 (LUN) を指定します。

Type:	Nullable<T>[Int32]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

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

-StorageAccountType

仮想マシンのマネージド ディスクのアカウントの種類。

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

-VM

このコマンドレットがデータ ディスクを変更する仮想マシンを指定します。 仮想マシン オブジェクトを取得するには、Get-AzVM コマンドレットを使用します。

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WriteAccelerator

データ ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

PSVirtualMachine

String

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

出力

PSVirtualMachine

関連リンク

• Get-AzVM
• Update-AzVM