Set-AzVMOSDisk
仮想マシンにオペレーティング システム ディスクのプロパティを設定します。
構文
Set-AzVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DiffDiskPlacement <String>]
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Windows]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DiffDiskPlacement <String>]
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Windows]
[-DiskEncryptionKeyUrl] <String>
[-DiskEncryptionKeyVaultId] <String>
[[-KeyEncryptionKeyUrl] <String>]
[[-KeyEncryptionKeyVaultId] <String>]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DiffDiskPlacement <String>]
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Linux]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DiffDiskPlacement <String>]
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Linux]
[-DiskEncryptionKeyUrl] <String>
[-DiskEncryptionKeyVaultId] <String>
[[-KeyEncryptionKeyUrl] <String>]
[[-KeyEncryptionKeyVaultId] <String>]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DiffDiskPlacement <String>]
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
Set-AzVMOSDisk コマンドレットは、仮想マシン上のオペレーティング システム ディスクのプロパティを設定します。
例
例 1: プラットフォーム イメージから仮想マシンのプロパティを設定する
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
Set-AzVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.10" -Version "latest"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption FromImage
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"最初のコマンドは、ResourceGroup11 という名前のリソース グループ内の AvailabilitySet13 という名前の可用性セットを取得し、そのオブジェクトを$AvailabilitySet変数に格納します。 2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 仮想マシンは、$AvailabilitySetに格納されている可用性セットに属します。 最後のコマンドは、$VirtualMachineの仮想マシンのプロパティを設定します。
例 2: 一般化されたユーザー イメージから仮想マシンのプロパティを設定する
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -SourceImageUri "https://mystorageaccount.blob.core.windows.net/vhds/myOSImage.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption fromImage -Linux
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"最初のコマンドは、ResourceGroup11 という名前のリソース グループ内の AvailabilitySet13 という名前の可用性セットを取得し、そのオブジェクトを$AvailabilitySet変数に格納します。 2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 仮想マシンは、$AvailabilitySetに格納されている可用性セットに属します。 最後のコマンドは、$VirtualMachineの仮想マシンのプロパティを設定します。
例 3: 特殊なユーザー イメージから仮想マシンのプロパティを設定する
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption Attach -Linux
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"最初のコマンドは、ResourceGroup11 という名前のリソース グループ内の AvailabilitySet13 という名前の可用性セットを取得し、そのオブジェクトを$AvailabilitySet変数に格納します。 2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 仮想マシンは、$AvailabilitySetに格納されている可用性セットに属します。 最後のコマンドは、$VirtualMachineの仮想マシンのプロパティを設定します。
例 4: 仮想マシンのオペレーティング システム ディスクにディスク暗号化設定を設定する
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite -Windows -CreateOption "Attach" -DiskEncryptionKeyUrl "https://mytestvault.vault.azure.net/secrets/Test1/514ceb769c984379a7e0230bddaaaaaa" -DiskEncryptionKeyVaultId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mytestvault"
New-AzVM -VM $VirtualMachine -ResourceGroupName " ResourceGroup11"次の使用例は、仮想マシンのオペレーティング システム ディスクにディスク暗号化設定を設定します。
パラメーター
オペレーティング システム ディスクのキャッシュ モードを指定します。 有効な値は次のとおりです。
- ReadOnly
- ReadWrite 既定値は ReadWrite です。 キャッシュ値を変更すると、仮想マシンが再起動します。 この設定は、ディスクのパフォーマンスに影響します。
| Type: | Nullable<T>[CachingTypes] |
| Accepted values: | None, ReadOnly, ReadWrite |
| Position: | 3 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このコマンドレットで、プラットフォームまたはユーザー イメージから仮想マシンにディスクを作成するか、既存のディスクを接続するかを指定します。 有効な値は次のとおりです。
- 添付。 特殊化されたディスクから仮想マシンを作成するには、このオプションを指定します。 このオプションを指定する場合は、 SourceImageUri パラメーターを指定しないでください。 代わりに、Set-AzVMSourceImage コマンドレットを使用します。 また、 Windows または Linux のパラメーターを使用して、VHD 上のオペレーティング システムの種類を Azure プラットフォームに伝える必要があります。 VhdUri パラメーターは、接続するディスクの場所を Azure プラットフォームに伝えるのに十分です。
- FromImage。 プラットフォーム イメージまたは一般化されたユーザー イメージから仮想マシンを作成するには、このオプションを指定します。 一般化されたユーザー イメージの場合は、Set-AzVMSourceImage コマンドレットを使用する代わりに、SourceImageUri パラメーターと Windows または Linux パラメーターを指定して、オペレーティング システム ディスク VHD の場所と種類を Azure プラットフォームに伝える必要もあります。 プラットフォーム イメージの場合は、 VhdUri パラメーターで十分です。
- 空白。
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
VM の削除後の OS ディスク削除オプションを指定します。 [デタッチ]、[削除] のオプション
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
オペレーティング システム ディスクのエフェメラル ディスクの配置を指定します。 このプロパティは、要求のユーザーが、エフェメラル OS ディスク プロビジョニング用のキャッシュ ディスクまたはリソース ディスク領域の場所を選択するために使用できます。 エフェメラル OS ディスク サイズの要件の詳細については、Windows VM のエフェメラル OS ディスク サイズ要件と Linux VM https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements の https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements要件に関するページを参照してください。 このパラメーターは、DiffDiskSetting パラメーターが 'Local' に設定されている場合にのみ使用できます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
オペレーティング システム ディスクの差分ディスク設定を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
ディスク暗号化キーの場所を指定します。
| Type: | String |
| Position: | 7 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ディスク暗号化キーを含むKey Vaultのリソース ID を指定します。
| Type: | String |
| Position: | 8 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
カスタマー マネージド ディスク暗号化セットのリソース ID を指定します。 これは、マネージド ディスクに対してのみ指定できます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オペレーティング システム ディスクのサイズ (GB 単位) を指定します。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
キー暗号化キーの場所を指定します。
| Type: | String |
| Position: | 9 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
キー暗号化キーを含むKey Vaultのリソース ID を指定します。
| Type: | String |
| Position: | 10 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ユーザー イメージ上のオペレーティング システムが Linux であることを示します。 ユーザー イメージ ベースの仮想マシンのデプロイにこのパラメーターを指定します。
| Type: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
マネージド ディスクの ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オペレーティング システム ディスクの名前を指定します。
| Type: | String |
| Aliases: | OSDiskName, DiskName |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ユーザー イメージ シナリオの VHD の URI を指定します。
| Type: | String |
| Aliases: | SourceImage |
| Position: | 4 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
マネージド ディスクのストレージ アカウントの種類を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
仮想ハード ディスク (VHD) の Uniform Resource Identifier (URI) を指定します。 イメージ ベースの仮想マシンの場合、このパラメーターは、プラットフォーム イメージまたはユーザー イメージが指定されたときに作成する VHD ファイルを指定します。 これは、イメージ バイナリ ラージ オブジェクト (BLOB) をコピーして仮想マシンを起動する場所です。 ディスク ベースの仮想マシンのブート シナリオの場合、このパラメーターは、仮想マシンが起動に直接使用する VHD ファイルを指定します。
| Type: | String |
| Aliases: | OSDiskVhdUri, DiskVhdUri |
| Position: | 2 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オペレーティング システム ディスクのプロパティを設定するローカル仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzVM コマンドレットを使用します。
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
ユーザー イメージ上のオペレーティング システムが Windows であることを示します。
| Type: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
OS ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
関連リンク
フィードバック
フィードバックの送信と表示