Share via

Set-SCSPFExtensibleEventHandler

  • Referência
Módulo:
spfadmin

Define um manipulador de eventos extensível no Service Provider Foundation.

Syntax

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

Description

O cmdlet Set-SCSPFExtensibleEventHandler invoca um runbook no System Center – Orchestrator para ser executado sempre que uma nova máquina virtual ou um novo serviço é criado. A máquina virtual ou o serviço deve ser criado por chamadas para o Service Provider Foundation com o serviço VMM (Virtual Machine Manager). O Service Provider Foundation gera eventos internos para invocar o runbook e o runbook será invocado continuamente, desde que o manipulador de eventos extensível esteja habilitado.

O Service Provider Foundation não invocará o runbook se a máquina virtual ou o serviço tiver sido criado por outros meios, como usando cmdlets do PowerShell para usando o console no VMM.

Para dar suporte à infraestrutura para invocar um runbook, o Service Provider Foundation chama o cmdlet Start-SCOrchestratorRunbook internamente; o usuário não precisa chamá-lo explicitamente.

Exemplos

Exemplo 1: definir um manipulador de eventos

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

Esse comando permite que um manipulador de eventos invoque um runbook.

Exemplo 2: Desabilitar um manipulador de eventos

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

Esse comando desabilita um manipulador de eventos de invocar um runbook porque o parâmetro Enable é omitido.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-Enable

Indica que o manipulador de eventos extensível está habilitado. Omita esse parâmetro para desabilitar o manipulador.

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

-EventName

Especifica VirtualMachineCreated ou ServiceCreated para o evento que invoca um runbook do Orchestrator.

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

-OrchestratorUri

Especifica o URI do serviço Web Orchestrator, conforme especificado pelo arquivo web.config em C:\Program Files (x86)\Microsoft System Center 2012\Orchestrator\Orchestration Console.

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

-RunbookPath

Especifica o caminho para um runbook no Orchestrator.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

System.Object