Get-AzVmssLifecycleHookEvent
仮想マシン スケール セット (VMSS) のライフサイクル フック イベントを一覧表示または取得します。
構文
ListParameterSet (既定)
Get-AzVmssLifecycleHookEvent
-ResourceGroupName <String>
-VMScaleSetName <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetParameterSet
Get-AzVmssLifecycleHookEvent
-ResourceGroupName <String>
-VMScaleSetName <String>
-Name <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Get-AzVmssLifecycleHookEvent コマンドレットは、仮想マシン スケール セット (VMSS) のすべてのライフサイクル フック イベントを一覧表示するか、特定のイベントを名前 (GUID) で取得します。 ライフサイクル フック イベントは、構成されたフックが自動 OS アップグレードフェーズ中に発生したときにプラットフォームによって作成されます。
イベントには、"アクティブ" (顧客の応答を待機中) または "完了" のいずれかの Properties.State があります。
例
例 1: VMSS のすべてのライフサイクル フック イベントを一覧表示する
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss'
この例では、指定した VMSS のすべてのライフサイクル フック イベントを一覧表示します。
例 2: 名前で特定のイベントを取得する
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
この例では、GUID 名で特定のライフサイクル フック イベントを取得します。
例 3: アクティブなイベントのみにフィルターを適用する
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' }
この例では、アクティブなライフサイクル フック イベントのみを一覧表示します。
例 4: パイプライン経由ですべてのアクティブなイベントを承認する
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' } |
Update-AzVmssLifecycleHookEvent -ActionState Approved
この例では、すべてのアクティブなイベントを取得し、パイプラインを通じて各イベントを承認します。
パラメーター
-DefaultProfile
Azureとの通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
取得するライフサイクル フック イベントの名前 (GUID)。 省略すると、VMSS のすべてのイベントが一覧表示されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
GetParameterSet
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ResourceGroupName
リソース グループの名前。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-VMScaleSetName
VM スケール セットの名前。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。