Set-SCSPFExtensibleEventHandler

  • リファレンス
モジュール:
spfadmin

Service Provider Foundation で拡張可能なイベント ハンドラーを設定します。

構文

Set-SCSPFExtensibleEventHandler
   -EventName <String>
   [-OrchestratorUri <String>]
   [-RunbookPath <String>]
   [-Enable]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-SCSPFExtensibleEventHandler コマンドレットは、新しい仮想マシンまたは新しいサービスが作成されるたびに実行する Runbook を System Center - Orchestrator で呼び出します。 仮想マシンまたはサービスは、仮想マシン マネージャー (VMM) サービスを使用した Service Provider Foundation の呼び出しによって作成する必要があります。 Service Provider Foundation では、Runbook を呼び出すために内部イベントが発生し、拡張可能なイベント ハンドラーが有効になっている限り、Runbook は継続的に呼び出されます。

仮想マシンまたはサービスが他の方法で作成された場合 (たとえば、VMM のコンソールを使用して PowerShell コマンドレットを使用するなど) は、Service Provider Foundation によって Runbook を呼び出しません。

Runbook を呼び出すためのインフラストラクチャをサポートするために、Service Provider Foundation は Start-SCOrchestratorRunbook コマンドレットを内部的に呼び出します。ユーザーは明示的に呼び出す必要はありません。

例

例 1: イベント ハンドラーを設定する

PS C:\>Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "https://scxspf-ws8-24:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable

このコマンドを使用すると、イベント ハンドラーで Runbook を呼び出すことができます。

例 2: イベント ハンドラーを無効にする

PS C:\>Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "https://scxspf-ws8-24:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created"

Enable パラメーターが 省略されているため、このコマンドでは、イベント ハンドラーが Runbook を呼び出すのを無効にします。

パラメーター

-Confirm

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

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

-Enable

拡張可能なイベント ハンドラーが有効になっていることを示します。 ハンドラーを無効にするには、このパラメーターを省略します。

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventName

Orchestrator Runbook を呼び出すイベントの VirtualMachineCreated または ServiceCreated を指定します。

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

-OrchestratorUri

C:\Program Files (x86)\Microsoft System Center 2012\Orchestrator\Orchestration Console の web.config ファイルで指定された Orchestrator Web サービスの URI を指定します。

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

-RunbookPath

Orchestrator の Runbook へのパスを指定します。

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

-WhatIf

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

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

入力

None

出力

System.Object