New-AzVmssLifecycleHookConfig
建立一個記憶體內生命週期鉤子設定物件,供虛擬機器縮放集(VMSS)使用。
語法
Default (預設值)
New-AzVmssLifecycleHookConfig
-Type <String>
[-WaitDuration <String>]
[-DefaultAction <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzVmssLifecycleHookConfig 指令檔會建立一個生命週期鉤子設定物件,可傳給 Set-AzVmssLifecycleHooksProfile 或 New-AzVmssConfig。
生命週期鉤子讓客戶能在 VMSS 自動作業系統升級階段前註冊觸發的鉤子,然後依每個虛擬機回應事件(批准、拒絕或延遲),然後平台繼續進行。
範例
範例 1:建立自動作業系統升級排程的生命週期鉤子
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
此範例會建立一個生命週期鉤子,會在自動作業系統升級排程前觸發,等待時間為 8 小時。 由於 -DefaultAction 未指定,服務在等待時間結束時會自動套用預設值。
範例 2:建立帶有明確預設動作的生命週期鉤子
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSRollingBatchStarting' -WaitDuration 'PT30M' -DefaultAction 'Approve'
此範例建立一個生命週期鉤子,會在每個滾動批次開始前觸發,等待時間為 30 分鐘,且預設動作為 Approve。
範例 3:在新的 VMSS 中使用 hook
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
$config = New-AzVmssConfig -Location 'eastus' -SkuCapacity 2
$config = Set-AzVmssLifecycleHooksProfile -VirtualMachineScaleSet $config -LifecycleHook $hook
New-AzVmss -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -VirtualMachineScaleSet $config
此範例建立一個帶有生命週期鉤子的 VMSS。
參數
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultAction
在生命週期鉤事件中,指定若平台未在等待時間結束前收到客戶回應,對目標資源所執行的動作。 接受的價值觀:「批准」、「拒絕」。 若未包含,服務會套用自己的預設值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | Approve, Reject |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 Azure 通訊的憑證、帳號、租戶和訂閱。
參數屬性
| 類型: | IAzureContextContainer |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | AzContext, AzureRmContext, AzureCredential |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Type
指定生命週期鉤的類型。 可能的值:「UpgradeAutoOSSchescheduleing」、「UpgradeAutoOSRollingBatchStarting」。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | UpgradeAutoOSScheduling, UpgradeAutoOSRollingBatchStarting |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WaitDuration
指定生命週期鉤子事件等待客戶回應後,在套用預設動作的時間長度。 必須符合ISO 8601的時長格式,例如「PT8H」(8小時)或「PT30M」(30分鐘)。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。