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を参照してください。

入力

String

出力

VMScaleSetLifecycleHookEvent