Set-SCSPFExtensibleEventHandler
Define um manipulador de eventos extensível no Service Provider Foundation.
Sintaxe
Default (Predefinição)
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 for criado. A máquina virtual ou serviço deve ser criado por chamadas para o Service Provider Foundation com o serviço Virtual Machine Manager (VMM). 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 usar 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
Este comando permite que um manipulador de eventos invoque um runbook.
Exemplo 2: Desativar 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"
Este comando desativa um manipulador de eventos de invocar um runbook porque o parâmetro Enable é omitido.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Enable
Indica que o manipulador de eventos extensível está habilitado. Omita esse parâmetro para desabilitar o manipulador.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-EventName
Especifica VirtualMachineCreated ou ServiceCreated para o evento que invoca um runbook do Orchestrator.
Propriedades dos parâmetros
| Tipo: | System.String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | System.String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RunbookPath
Especifica o caminho para um runbook no Orchestrator.
Propriedades dos parâmetros
| Tipo: | System.String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.