az vm unmanaged-disk

VM に接続されているアンマネージド データ ディスクを管理します。

Azure Virtual Machines は、オペレーティング システム、アプリケーション、およびデータを格納する場所としてディスクを使用します。 すべての Azure 仮想マシンには、オペレーティング システム ディスクと一時ディスクの 2 つ以上のディスクがあります。 オペレーティング システム ディスクはイメージから作成され、オペレーティング システム ディスクとイメージの両方が、実際には Azure ストレージ アカウントに格納されている仮想ハード ディスク (VHD) です。 仮想マシンには、VHD としても格納される 1 つ以上のデータ ディスクを含めることもできます。

Azure マネージド データ ディスクとアンマネージド データ ディスクの最大サイズは 4095 GB です (プレビューでは大きなディスクを除く)。 Azure アンマネージド ディスクの最大容量も 4095 GB です。

詳細については、以下を参照してください。

• Azure ディスク - https://learn.microsoft.com/azure/virtual-machines/managed-disks-overview。
• パブリック プレビューの大規模なマネージド ディスク - https://azure.microsoft.com/blog/introducing-the-public-preview-of-larger-managed-disks-sizes/
• パブリック プレビューの Ultra SSD マネージド ディスク - https://learn.microsoft.com/azure/virtual-machines/disks-types。

コマンド

名前	説明	型	状態
az vm unmanaged-disk attach	非管理対象の永続ディスクを VM に接続します。	Core	GA
az vm unmanaged-disk detach	VM からアンマネージド ディスクをデタッチします。	Core	GA
az vm unmanaged-disk list	VM のアンマネージド ディスクを一覧表示します。	Core	GA

az vm unmanaged-disk attach

非管理対象の永続ディスクを VM に接続します。

これにより、メンテナンスやサイズ変更のために VM が再プロビジョニングされた場合でも、データを保持できます。

az vm unmanaged-disk attach --resource-group
                            --vm-name
                            [--caching {None, ReadOnly, ReadWrite}]
                            [--lun]
                            [--name]
                            [--new]
                            [--size-gb]
                            [--vhd-uri]

例

新しい既定サイズ (1023 GB) の非管理対象データ ディスクを VM に接続します。

az vm unmanaged-disk attach -g MyResourceGroup --vm-name MyVm --new

既存のデータ ディスクを非管理対象として VM に接続します。

az vm unmanaged-disk attach -g MyResourceGroup --vm-name MyVm --name MyDataDisk \
    --vhd-uri https://mystorage.blob.core.windows.net/vhds/d1.vhd

非管理対象の永続ディスクを VM に接続します。 (autogenerated)

az vm unmanaged-disk attach --name MyDataDisk --new --resource-group MyResourceGroup --size-gb 50 --vm-name MyVm

必須のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--vm-name

仮想マシンの名前。 既定値は、 az configure --defaults vm=<name>を使用して構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--caching

ディスク キャッシュ ポリシー。

プロパティ	値
指定可能な値:	None, ReadOnly, ReadWrite

--lun

0 ベースの論理ユニット番号 (LUN)。 最大値は、仮想マシンのサイズによって異なります。

--name -n

データ ディスク名。

--new

新しいディスクを作成します。

プロパティ	値
規定値:	False

--size-gb -z

GB 単位のサイズ。 最大サイズ: 4095 GB (特定のプレビュー ディスクは大きくなる可能性があります)。

プロパティ	値
規定値:	1023

--vhd-uri

仮想ハード ディスク URI。 (例: https://mystorage.blob.core.windows.net/vhds/d1.vhd)。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az vm unmanaged-disk detach

VM からアンマネージド ディスクをデタッチします。

az vm unmanaged-disk detach --name
                            --resource-group
                            --vm-name

例

VM からデータ ディスクをデタッチします。

az vm unmanaged-disk detach -g MyResourceGroup --vm-name MyVm -n disk_name

必須のパラメーター

--name -n

データ ディスク名。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--vm-name

仮想マシンの名前。 既定値は、 az configure --defaults vm=<name>を使用して構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az vm unmanaged-disk list

VM のアンマネージド ディスクを一覧表示します。

az vm unmanaged-disk list --name --vm-name
                          --resource-group

例

VM に接続されているアンマネージド ディスクを一覧表示します。

az vm unmanaged-disk list -g MyResourceGroup --vm-name MyVm

"data_disk" という文字列を含む名前を持つアンマネージド ディスクを一覧表示します。

az vm unmanaged-disk list -g MyResourceGroup --vm-name MyVm \
    --query "[?contains(name, 'data_disk')]" --output table

必須のパラメーター

--name --vm-name -n

仮想マシンの名前。 既定値は、 az configure --defaults vm=<name>を使用して構成できます。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False