次の方法で共有


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

入力

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