Como Automatizar um Runbook a partir do Service Provider Foundation

 

Publicado: junho de 2016

Aplica-se a: System Center 2012 SP1 - Orchestrator, System Center 2012 R2 Orchestrator

A partir do Base do provedor de serviçosSystem Center 2012 R2 é possível configurar o Service Management Automation para utilizar o Base do provedor de serviços. Para obter mais informações, consulte a seção "Conexão com o serviço da web do SMA" de Gerenciar serviços Web e conexões no Service Provider Foundation. Você também pode invocar runbooks com o antigo cenário invocar runbook.

Você pode automatizar runbooks utilizando o Service Management Automation, desde que tenha configurado o Service Management Automation para utilizar a Base do provedor de serviços por meio dos cmdlets Set-SCSPFEventRegisration e Get-SCSPFEventRegistation, conforme mostrado no exemplo a seguir.

PS C:\> # This command sets a runbook to be invoked when the Create event for a new virtual machine is raised.
PS C:\> Set-SCSPFEventRegistration –ResourceName "VMM.VirtualMachine" – ActionName "Create" –RunbookName "Invoke-SampleCmdlet"
PS C:\> 
PS C:\> # This command gets an event with the Action parameter and stores it in the $event_backup variable.
PS C:\> $event_backup = Get-SCSPFEventRegistration –Action "Backup"

O restante deste tópico descreve o cenário mais antigo.

Invocar runbooks (não automação)

Você pode definir um runbook no System Center 2012 - Orchestrador para ser executado sempre que uma nova máquina virtual ou um novo serviço é criado por chamadas remotas para o Base do provedor de serviços com o Serviço do Virtual Machine Manager. Você pode definir o runbook para ser chamado por meio do cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler do Windows PowerShell. O Base do provedor de serviços emite eventos internos para chamar o runbook, que será chamado continuamente contanto que o manipulador de eventos extensíveis seja habilitado.

O Base do provedor de serviços não chamará o runbook se a máquina virtual ou o serviço tiver sido criado por outros meios; por exemplo, através dos cmdlets do Windows PowerShell ou do console no System Center 2012 – Virtual Machine Manager (VMM).

Para oferecer suporte à infraestrutura usada para chamar um runbook, o Base do provedor de serviços chama o cmdlet Start-SCOrchestratorRunbook internamente; o usuário não precisa chamá-lo explicitamente.

Verifique se você tem as seguintes informações e configurações aplicadas antes de chamar o cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler:

  • O URI para o serviço Web Orchestrator.

  • As configurações de identidade dos Pools de Aplicativos do Base do provedor de serviços no Gerenciador dos Serviços de Informações da Internet (IIS) devem ser incluídas no grupo de usuários do Orchestrator. Para obter informações sobre como determinar as credenciais que foram aplicadas para o Base do provedor de serviços, consulte a seção "Verificar credenciais de usuário local para acesso ao portal" em 4c766289-4f3c-4990-be7e-4181f99438ee#LocalCreds. Para obter informações sobre como adicionar credenciais ao grupo de usuários do Orchestrator, consulte Como alterar o grupo de usuários do Orchestrator.

Consulte Parâmetros de Runbooks chamados do Service Provider Foundation para obter uma lista de parâmetros fornecidos automaticamente ao runbook.

Para chamar um runbook no Service Provider Foundation

  • Chame o T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler com os seguintes parâmetros:

    Parâmetro

    Valor

    EventName

    Especifique "VirtualMachineCreated" ou "ServiceCreated".

    OrchestratorUri

    O URI para o serviço Web Orchestrator.

    RunbookPath

    O caminho local para o runbook.

    Habilitar

    Especifique para habilitar o runbook.

    Para que o runbook não seja chamado, omita este parâmetro.

    Exemplo:

     PS C:\> Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "http://east.contoso.com:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable
    

Para determinar o valor para o qual o manipulador de eventos extensíveis será definido, chame o cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler.

Para que um runbook não seja chamado

  • Repita o comando T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler, mas sem o parâmetro Enable. Você também pode especificar cadeias de caracteres vazias para os parâmetros OrchestratorUri e Runbookpath, conforme mostrado no exemplo a seguir:

     PS C:\> Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "" -RunbookPath ""