Set-SCSPFExtensibleEventHandler
在 Service Provider Foundation 中设置可扩展的事件处理程序。
语法
Set-SCSPFExtensibleEventHandler
-EventName <String>
[-OrchestratorUri <String>]
[-RunbookPath <String>]
[-Enable]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-SCSPFExtensibleEventHandler cmdlet 在 System Center - Orchestrator 中调用 Runbook,以便在创建新虚拟机或新服务时运行。 必须使用 Virtual Machine Manager (VMM) 服务调用 Service Provider Foundation 来创建虚拟机或服务。 Service Provider Foundation 引发内部事件以调用 Runbook,只要启用了可扩展事件处理程序,Runbook 就会持续调用。
如果虚拟机或服务是通过其他方式创建的,则 Service Provider Foundation 不会调用 Runbook,例如通过使用 VMM 中的控制台为 使用 PowerShell cmdlet。
为了支持调用 Runbook 的基础结构,Service Provider Foundation 在内部调用 Start-SCOrchestratorRunbook cmdlet;用户不需要显式调用它。
示例
示例 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"
此命令禁止事件处理程序调用 Runbook,因为省略 了 Enable 参数。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
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
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
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