Set-AzVmssRollingUpgradePolicy

リファレンス

モジュール:: Az.Compute

VMSS ローリングアップグレードポリシーのプロパティを設定します。

構文

Set-AzVmssRollingUpgradePolicy
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-MaxBatchInstancePercent] <Int32>]
   [[-MaxUnhealthyInstancePercent] <Int32>]
   [[-MaxUnhealthyUpgradedInstancePercent] <Int32>]
   [-PauseTimeBetweenBatches <String>]
   [-EnableCrossZoneUpgrade <Boolean>]
   [-PrioritizeUnhealthyInstance <Boolean>]
   [-MaxSurge <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

VMSS ローリングアップグレードポリシーのプロパティを設定します。

例

例 1

Set-AzVmssRollingUpgradePolicy -VirtualMachineScaleSet $vmss -MaxBatchInstancePercent 40 -MaxUnhealthyInstancePercent 35 -MaxUnhealthyUpgradedInstancePercent 30 -PauseTimeBetweenBatches "PT30S"

このコマンドは、MaxBatchInstance の場合は 40%、MaxUnhealthyInstance の場合は 35%、MaxUnhealthyUpgradedInstance の場合は 30%、VMSS ローカルオブジェクト $vmssのバッチ間の 30 秒の一時停止時間を設定します。

パラメーター

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableCrossZoneUpgrade

アップグレードバッチを構築するときに、VMSS が AZ 境界を無視できるようにします。バッチサイズを決定するには、Update Doメインと maxBatchInstancePercent を考慮してください。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxBatchInstancePercent

1 回のバッチでのローリングアップグレードによって同時にアップグレードされる仮想マシンインスタンスの合計数に対する最大割合。これは最大であるため、以前または将来のバッチの異常なインスタンスでは、信頼性を高めるためにバッチ内のインスタンスの割合が減少する可能性があります。値が指定されていない場合は、20 に設定されます。

Type:	Int32
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxSurge

有効にすると、VMSS は、既存の仮想マシンを更新するのではなく、スケールセットをアップグレードするための新しい仮想マシンを作成します。既存の仮想マシンは、バッチごとに新しい仮想マシンが作成されると削除されます。

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxUnhealthyInstancePercent

アップグレードの結果として、またはローリングアップグレードが中止される前に仮想マシンの正常性チェックによって異常な状態で検出された場合に、同時に異常になる可能性があるスケールセット内の仮想マシンインスタンスの合計数に対する最大割合。この制約は、バッチを開始する前にチェックされます。値が指定されていない場合は、20 に設定されます。

Type:	Int32
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxUnhealthyUpgradedInstancePercent

異常な状態にあると検出できるアップグレードされた仮想マシンインスタンスの最大割合。このチェックは、各バッチがアップグレードされた後に発生します。この割合を超えた場合、ローリングアップデートは中止されます。値が指定されていない場合は、20 に設定されます。

Type:	Int32
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PauseTimeBetweenBatches

すべての仮想マシンの更新を 1 つのバッチで完了してから次のバッチを開始するまでの待機時間。期間は ISO 8601 形式で指定する必要があります。既定値は 0 秒 (PT0S) です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PrioritizeUnhealthyInstance

正常なインスタンスの前に、スケールセット内のすべての異常なインスタンスをアップグレードします。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualMachineScaleSet

VMSS オブジェクトを指定します。 New-AzVmssConfig コマンドレットを使用してオブジェクトを作成できます。

Type:	PSVirtualMachineScaleSet
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

PSVirtualMachineScaleSet

Int32

String

出力