Update-AzVmssVM
構文
DefaultParameter (既定)
Update-AzVmssVM
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[-InstanceId] <String>
[-ProxyAgentKeyIncarnationId <Int32>]
[-DataDisk <PSVirtualMachineDataDisk[]>]
[-ProtectFromScaleIn <Boolean>]
[-ProtectFromScaleSetAction <Boolean>]
[-AsJob]
[-UserData <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdParameter
Update-AzVmssVM
[-ResourceId] <String>
[-ProxyAgentKeyIncarnationId <Int32>]
[-DataDisk <PSVirtualMachineDataDisk[]>]
[-ProtectFromScaleIn <Boolean>]
[-ProtectFromScaleSetAction <Boolean>]
[-AsJob]
[-UserData <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ObjectParameter
Update-AzVmssVM
[-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
[-ProxyAgentKeyIncarnationId <Int32>]
[-DataDisk <PSVirtualMachineDataDisk[]>]
[-ProtectFromScaleIn <Boolean>]
[-ProtectFromScaleSetAction <Boolean>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Vmss VM の状態を更新します。 現時点では、許可される更新プログラムはマネージド データ ディスクの追加のみです。
例
例 1: New-AzVMDataDisk を使用して Vmss VM にマネージド データ ディスクを追加する
$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$datadisk = New-AzVMDataDisk -Caching 'ReadOnly' -Lun 2 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
Update-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0 -DataDisk $datadisk
最初のコマンドは、既存のマネージド ディスクを取得します。
次のコマンドでは、マネージド ディスクを使用してデータ ディスク オブジェクトを作成します。
次のコマンドは、リソース グループ名、vmss 名、およびインスタンス ID によって指定された既存の Vmss VM を取得します。
最後のコマンドでは、新しいデータ ディスクを追加して Vmss VM を更新します。
例 2: Add-AzVMDataDisk を使用して Vmss VM にマネージド データ ディスクを追加する
$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
$VmssVM = Add-AzVMDataDisk -VM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
Update-AzVmssVM -VirtualMachineScaleSetVM $VmssVM
最初のコマンドは、既存のマネージド ディスクを取得します。
次のコマンドは、リソース グループ名、vmss 名、およびインスタンス ID によって指定された既存の Vmss VM を取得します。
次のコマンドは、$VmssVMにローカルに格納されている Vmss VM にマネージド ディスクを追加します。
最後のコマンドは、追加されたデータ ディスクを使用して Vmss VM を更新します。
例 3
Vmss VM の状態を更新します。 (autogenerated)
Update-AzVmssVM -InstanceId 0 -ProtectFromScaleIn $false -ProtectFromScaleSetAction $false -ResourceGroupName 'myrg' -VMScaleSetName 'myvmss'
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DataDisk
Vmss VM の状態を更新します。 現時点では、許可される更新プログラムはマネージド データ ディスクの追加のみです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-InstanceId
VMSS VM のインスタンス ID を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
DefaultParameter
配置: 2
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-ProtectFromScaleIn
スケールイン操作中に仮想マシン スケール セット VM を削除対象と見なしてはならないことを示します。
パラメーターのプロパティ
型: Boolean
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ProtectFromScaleSetAction
VMSS で開始されたモデルの更新またはアクション (スケールインを含む) を VMSS VM に適用しないことを示します。
パラメーターのプロパティ
型: Boolean
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ProxyAgentKeyIncarnationId
このパラメーターの値を大きくすると、ユーザーはゲストとホスト間の通信チャネルをセキュリティで保護するために使用されるキーをリセットできます。
パラメーターのプロパティ
型: Nullable<T> [ Int32 ]
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: KeyIncarnationId
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-ResourceGroupName
VMSS のリソース グループの名前を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
DefaultParameter
配置: 0
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-ResourceId
仮想マシン スケール セット VM のリソース ID
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
ResourceIdParameter
配置: 0
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-UserData
Base-64 でエンコードされる Vmss Vm の UserData。 顧客はここでシークレットを渡すべきではありません。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
DefaultParameter
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
ResourceIdParameter
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-VirtualMachineScaleSetVM
ローカル仮想マシン スケール セット VM オブジェクト
パラメーターのプロパティ
パラメーター セット
ObjectParameter
配置: 0
必須: True
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VMScaleSetName
仮想マシン スケール セットの名前
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: 名前
パラメーター セット
DefaultParameter
配置: 1
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
型: SwitchParameter
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: ウィスコンシン
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力