New-AzDiskConfig

リファレンス

モジュール:: Az.Compute

構成可能なディスクオブジェクトを作成します。

構文

New-AzDiskConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-LogicalSectorSize <Int32>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-Zone <String[]>]
   [-HyperVGeneration <String>]
   [-DiskIOPSReadWrite <Int64>]
   [-DiskMBpsReadWrite <Int64>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-Tag <Hashtable>]
   [-CreateOption <String>]
   [-StorageAccountId <String>]
   [-ImageReference <ImageDiskReference>]
   [-GalleryImageReference <ImageDiskReference>]
   [-SourceUri <String>]
   [-SourceResourceId <String>]
   [-UploadSizeInBytes <Int64>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-DiskAccessId <String>]
   [-NetworkAccessPolicy <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-PerformancePlus <Boolean>]
   [-OptimizedForFrequentAttach <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzDiskConfig コマンドレットは、構成可能なディスクオブジェクトを作成します。

例

例 1

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 5 -SkuName Standard_LRS -OsType Windows -CreateOption Empty -EncryptionSettingsEnabled $true;
$secretUrl = 'https://myvault.vault-int.azure-int.net/secrets/123/';
$secretId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault123';
$keyUrl = 'https://myvault.vault-int.azure-int.net/keys/456';
$keyId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault456';
$diskconfig = Set-AzDiskDiskEncryptionKey -Disk $diskconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskconfig = Set-AzDiskKeyEncryptionKey -Disk $diskconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;

最初のコマンドでは、ストレージアカウントの種類にサイズ 5 GB のローカル空のディスクオブジェクトStandard_LRS作成します。また、Windows OS の種類を設定し、暗号化設定を有効にします。 2 番目と 3 番目のコマンドは、ディスクオブジェクトのディスク暗号化キーとキー暗号化キーの設定を設定します。最後のコマンドは、ディスクオブジェクトを取得し、リソースグループ 'ResourceGroup01' に 'Disk01' という名前のディスクを作成します。

例 2

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 1023 -SkuName Standard_LRS -OsType Windows -CreateOption Upload -DiskIOPSReadWrite 500 -DiskMBpsReadWrite 8;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;
$diskSas = Grant-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DurationInSecond 86400 -Access 'Write'
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ReadyToUpload'
 AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:$diskSas
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ActiveUpload'
Revoke-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'

最初のコマンドは、アップロード用のローカルディスクオブジェクトを作成します。 2 番目のコマンドは、ディスクオブジェクトを取得し、リソースグループ 'ResourceGroup01' に 'Disk01' という名前のディスクを作成します。 3 番目のコマンドは、ディスクの SAS URL を取得します。 4 番目のコマンドは、ディスクの状態を取得します。ディスクの状態が "ReadyToUpload" の場合、ユーザーは AzCopy を使用して BLOB ストレージからディスク SAS URL にディスクをアップロードできます。アップロード中に、ディスクの状態が 'ActiveUpload' に変更されます。最後のコマンドは、SAS URL のディスクアクセスを取り消します。

例 3

$galleryImageReference = @{Id = '/subscriptions/0296790d-427c-48ca-b204-8b729bbd8670/resourceGroups/swaggertests/providers/Microsoft.Compute/galleries/swaggergallery/images/swaggerimagedef/versions/1.0.0'; Lun=1}
$diskConfig = New-AzDiskConfig -Location 'West US' -CreateOption 'FromImage' -GalleryImageReference $galleryImageReference;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

共有ギャラリーイメージバージョンからディスクを作成します。 ID は、共有ギャラリーイメージバージョンの ID です。 Lun は、ソースがデータディスクの場合にのみ必要です。

例 4

$diskconfig = New-AzDiskConfig -Location 'Central US' -SkuName 'Standard_LRS' -OsType 'Windows' -UploadSizeInBytes 35183298347520 -CreateOption 'Upload' -OptimizedForFrequentAttach $true
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

OptimizedForFrequentAttach を true にしてディスクを作成すると、1 つの仮想マシンから頻繁に (1 日に 5 回以上) 切断され、別の仮想マシンに接続されるデータディスクの信頼性とパフォーマンスが向上します。

パラメーター

-AcceleratedNetwork

TRUE の場合は、OS ディスクの作成元のイメージが高速ネットワークをサポートしています。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Architecture

OS ディスクでサポートされている CPU アーキテクチャ。指定できる値は、"X64" と "Arm64" です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-BurstingEnabled

プロビジョニングされたディスクのパフォーマンスターゲットを超えるバーストを有効にします。バーストは既定で無効になっています。 Ultra ディスクには適用されません。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CreateOption

このコマンドレットで、プラットフォームまたはユーザーイメージから仮想マシンにディスクを作成するか、空のディスクを作成するか、既存のディスクを接続するかを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DataAccessAuthMode

ディスクまたはスナップショットにエクスポートまたはアップロードするときの追加の認証要件。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiskAccessId

プライベートエンドポイントを使用するための DiskAccess リソースの ARM ID を取得または設定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskEncryptionKey

ディスク上のディスク暗号化キーオブジェクトを指定します。

型:	KeyVaultAndSecretReference
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskEncryptionSetId

保存時の暗号化を有効にするために使用するディスク暗号化セットのリソース ID を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskIOPSReadOnly

共有ディスクを ReadOnly としてマウントしているすべての VM で許可される IOPS の合計数。 1 つの操作で 4k から 256k バイトの間で転送できます。

型:	Int64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskIOPSReadWrite

このディスクで許可される IOPS の数。UltraSSD ディスクに対してのみ設定できます。 1 つの操作で 4k から 256k バイトの間で転送できます。

型:	Int64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskMBpsReadOnly

共有ディスクを ReadOnly としてマウントしているすべての VM で許可される合計スループット (MBps)。 MBps は、1 秒あたり数百万バイトを意味します。ここでの MB では、10 の累乗の ISO 表記が使用されます。

型:	Int64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskMBpsReadWrite

このディスクで許可される帯域幅。UltraSSD ディスクに対してのみ設定できます。 MBps は、1 秒あたり数百万バイトを意味します。ここでの MB では、10 の累乗の ISO 表記が使用されます。

型:	Int64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DiskSizeGB

ディスクのサイズを GB 単位で指定します。

型:	Int32
配置:	2
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-EdgeZone

エッジゾーン名を設定します。設定すると、クエリはメインリージョンではなく、指定されたエッジゾーンにルーティングされます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-EncryptionSettingsEnabled

暗号化設定を有効にします。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-EncryptionType

ディスクのデータを暗号化するために使用されるキーの種類。使用可能な値: 'EncryptionAtRestWithPlatformKey'、'EncryptionAtRestWithCustomerKey'

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-GalleryImageReference

GalleryImageReference オブジェクト。ギャラリーイメージから作成する場合に必要です。 ID は、ディスクの作成元となる共有ゲライメージバージョンの ARM ID になります。コピーのソースがギャラリーイメージ内のデータディスクの 1 つである場合は、lun が必要です。null の場合、イメージの OS ディスクがコピーされます。

型:	ImageDiskReference
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-HyperVGeneration

仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。使用できる値は V1 と V2 です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ImageReference

ディスク上のイメージ参照を指定します。 ID は、ディスクの作成元となる PIR またはユーザーイメージの ARM ID です。コピーのソースがギャラリーイメージ内のデータディスクの 1 つである場合は、LUN が必要です。null の場合、イメージの OS ディスクがコピーされます。

型:	ImageDiskReference
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-KeyEncryptionKey

ディスク上のキー暗号化キーを指定します。

型:	KeyVaultAndKeyReference
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Location

場所を指定します。

型:	String
配置:	3
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-LogicalSectorSize

Ultra ディスクの論理セクターサイズ (バイト単位)。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-MaxSharesCount

ディスクに同時に接続できる VM の最大数。 1 より大きい値は、複数の VM に同時にマウントできるディスクを示します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-NetworkAccessPolicy

ネットワークアクセスポリシーは、ネットワークアクセスポリシーを定義します。使用可能な値は、'AllowAll'、'AllowPrivate'、'DenyAll' です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-OptimizedForFrequentAttach

このプロパティを true に設定すると、1 つの仮想マシンからデタッチして別の仮想マシンに接続することで、頻繁に (1 日に 5 回以上) データディスクの信頼性とパフォーマンスが向上します。このプロパティは、ディスクが仮想マシンの障害ドメインと一致しなくなるため、デタッチされず、頻繁に接続されていないディスクには設定しないでください。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-OsType

OS の種類を指定します。

型:	Nullable<T>[OperatingSystemTypes]
指定可能な値:	Windows, Linux
配置:	1
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PerformancePlus

このフラグを true に設定すると、デプロイされたディスクのパフォーマンスターゲットが向上します。それぞれのパフォーマンスターゲットについては、こちらを参照してください。このフラグは、ディスク作成時にのみ設定でき、有効にした後は無効にできません。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PublicNetworkAccess

ディスク上のエクスポートを制御するためのポリシー。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PurchasePlan

ディスクの購入プランを指定します。

型:	PSPurchasePlan
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-SkuName

ストレージアカウントの SKU 名を指定します。使用可能な値は、Standard_LRS、Premium_LRS、StandardSSD_LRS、およびUltraSSD_LRS、Premium_ZRS、およびStandardSSD_ZRSです。 UltraSSD_LRSは、CreateOption パラメーターの空の値でのみ使用できます。

型:	String
Aliases:	AccountType
配置:	0
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-SourceResourceId

ソースリソース ID を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-SourceUri

ソース URI を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-StorageAccountId

ストレージアカウント ID を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-SupportsHibernation

お客様は、ディスクに SupportsHibernation フラグを設定できます。

型:	Nullable<T>[Boolean]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Tag

ハッシュテーブルの形式のキーと値のペア。例: @{key0="value0";key1=$null;key2="value2"}

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Tier

ディスクのパフォーマンスレベル。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UploadSizeInBytes

CreateOption が Upload の場合、VHD フッターを含むアップロードの内容のサイズを指定します。この値は、20972032 (VHD フッターの場合は 20 MiB + 512 バイト) と35183298347520 バイト (VHD フッターの場合は 32 TiB + 512 バイト) の間である必要があります。

型:	Int64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Zone

ディスクの論理ゾーンの一覧を指定します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

入力

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

String[]

Hashtable

ImageDiskReference

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

KeyVaultAndSecretReference

KeyVaultAndKeyReference

出力

PSDisk

次の方法で共有