Automatizar e invocar runbooks de SPFAutomate and invoke runbooks from SPF

Manzanas para: System Center 2016Apples To: System Center 2016

Puede usar SPF y Service Management Automation conjuntamente para proporcionar soluciones automatizadas para los inquilinos.You can use SPF and Service Management Automation together to provide automated solutions for your tenants.

  • Puede configurar eventos en Service Provider Foundation que va a usar el servicio web Service Management Automation.You can configure events in Service Provider Foundation that the Service Management Automation web service will use.
  • Puede usar el antiguo escenario para invocar runbooks que se incluía en System Center 2012.You can use the older invoke runbook scenario that was included in System Center 2012.

Automatizar runbooksAutomate runbooks

Puede automatizar runbooks mediante Service Management Automation, siempre que haya configurado la automatización de administración de servicio para usar SPF, mediante el conjunto-SCSPFEventRegisration y Get-SCSPFEventRegistation cmdlets, como se muestra en el ejemplo siguiente.You can automate runbooks using Service Management Automation provided that you have configured the Service Management Automation to use SPF, by using the Set-SCSPFEventRegisration and Get-SCSPFEventRegistation cmdlets, as shown in the following example.

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"  

Invocar runbooks (escenario anterior)Invoke runbooks (old scenario)

Puede configurar un runbook de System Center 2016 o Orchestrator 2012 o System Center 2012 Orchestrator para ejecutarse cada vez que se crea una nueva máquina virtual o servicio mediante llamadas remotas a SPF con VMM.You can set a runbook in System Center 2016 or 2012 Orchestrator or System Center 2012 Orchestrator to be run whenever a new VM or service is created by remote calls to SPF with VMM.

  • Puede establecer el runbook se invoque mediante el t de Windows PowerShell-SCSPFExtensibleEventHandler cmdlet.You can set the runbook to be invoked by using the Windows PowerShell T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler cmdlet.
  • SPF genera eventos internos para invocar el runbook y el runbook continuará invocándose continua mientras esté habilitado el controlador de eventos extensible.SPF raises internal events to invoke the runbook and the runbook will continue to be invoked continuously as long as the extensible event handler is enabled.
  • SPF no invoque el runbook si la máquina virtual o el servicio se creó por otros medios, como mediante el uso de cmdlets de Windows PowerShell, o mediante la consola VMM.SPF won't invoke the runbook if the VM or service was created by other means, such as by using Windows PowerShell cmdlets, or by using the VMM console.
  • Para admitir la infraestructura para invocar un runbook, llama a Service Provider Foundation la Start-SCOrchestratorRunbook cmdlet internamente y lo que no debe llamarse explícitamente por el usuario.To support the infrastructure for invoking a runbook, Service Provider Foundation calls the Start-SCOrchestratorRunbook cmdlet internally and it does to need to be explicitly called by the user.
  • Asegúrese de que tiene la siguiente información y configuración aplicadas antes de llamar a la t-SCSPFExtensibleEventHandler cmdlet:Make sure you have the following information and settings applied before you call the T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler cmdlet:
    • La dirección URL para el servicio web Orchestrator.The URL to the Orchestrator web service.
    • La configuración de identidad para los grupos de aplicaciones de servicio de proveedor Foundation en Internet Information Services (IIS) Manager deben incluirse en el grupo de usuarios de Orchestrator.The identity settings for the Service Provider Foundation Application Pools in Internet Information Services (IIS) Manager must be included in the Orchestrator Users Group.

Invoque un runbook como se indica a continuación:Invoke a runbook as follows:

  1. Llame a la t-SCSPFExtensibleEventHandler con los siguientes parámetros:Call the T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler with following parameters:

    ParámetroParameter ValorValue
    EventNameEventName Especifique "VirtualMachineCreated" o "ServiceCreated".Specify either "VirtualMachineCreated" or "ServiceCreated".
    OrchestratorUriOrchestratorUri El URI para el servicio web Orchestrator.The URI to the Orchestrator web service.
    RunbookPathRunbookPath La ruta de acceso local al Runbook.The local path to the runbook.
    HabilitarEnable Especifique este parámetro para habilitar el Runbook.Specify to enable the runbook.

    Para deshabilitar la invocación del Runbook, ignore este parámetro.To disable the runbook from being invoked, omit this parameter.

    Ejemplo:Example:

    PS C:\> Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "http://east.contoso.com:82/Orchestrator2016/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable  
    
  2. Para determinar lo que el controlador de eventos extensible, llame a la t-SCSPFExtensibleEventHandler cmdlet.To determine what the extensible event handler is set to, call the T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler cmdlet.

  3. Si desea deshabilitar la invocación de un runbook, repita el t-SCSPFExtensibleEventHandler de comandos, pero sin la habilitar parámetro.If you want to disable a runbook from being invoked, repeat the T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler command, but without the Enable parameter. También puede especificar cadenas vacías para los parámetros OrchestratorUri y Runbookpath como se muestra en el ejemplo siguiente:You can also specify empty strings for the OrchestratorUri and Runbookpath parameters as shown in the following example:

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

    Parámetros de runbookRunbook parameters

Esta lista de parámetros se proporciona automáticamente al runbook.This list of parameters is automatically provided to the runbook. Un Runbook no es necesario para procesar todos los parámetros que recibe y simplemente omitirá todos los parámetros que no tengan ningún propósito en el Runbook.A runbook is not required to process all the parameters it receives, and will simply ignore the parameters which have no purpose in the runbook.

Parámetros de una nueva máquina virtualParameters for a new virtual machine

La tabla siguiente muestra los parámetros disponibles cuando se crea una nueva máquina virtual.The following table lists the parameters available when a new virtual machine is created. Todos los parámetros son opcionales a menos que se indique que son necesarios.All parameters are optional unless indicated as required.

ParámetroParameter Tipo de datosData Type
StampId (necesarios)StampId (required) GuidGuid
Nombre de (nombre de StampID - obligatorio)Name (StampID name - required) StringString
CloudId (necesarios)CloudId (required) GuidGuid
VMTemplateIdVMTemplateId GuidGuid
HardwareProfileIdHardwareProfileId GuidGuid
VirtualHardDiskIdVirtualHardDiskId GuidGuid
DescripciónDescription StringString
CostCenterCostCenter StringString
EtiquetaTag StringString
ComputerNameComputerName StringString
BlockDynamicOptimizationBlockDynamicOptimization BooleanBoolean
CPULimitForMigrationCPULimitForMigration BooleanBoolean
CPULimitFunctionalityCPULimitFunctionality BooleanBoolean
CPURelativeWeightCPURelativeWeight Int32Int32
DelayStartSecondsDelayStartSeconds Int32Int32
DominioDomain StringString
UserNameUserName StringString
ContraseñaPassword StringString
DynamicMemoryBufferPercentageDynamicMemoryBufferPercentage Int32Int32
DynamicMemoryEnabledDynamicMemoryEnabled BooleanBoolean
DynamicMemoryMaximumMBDynamicMemoryMaximumMB Int32Int32
FullNameFullName StringString
MemoriaMemory Int32Int32
MemoryWeightMemoryWeight Int32Int32
OrganizationNameOrganizationName StringString
StartActionStartAction StringString
StartVMStartVM BooleanBoolean
StopActionStopAction StringString
CPUCountCPUCount ByteByte
PropietarioOwner PSObjectPSObject
ProductKeyProductKey StringString
WorkGroupWorkGroup StringString
TimeZoneTimeZone Int32Int32
RunAsAccountUserNameRunAsAccountUserName StringString
LocalAdminRunAsAccountNameLocalAdminRunAsAccountName StringString
LocalAdminUserNameLocalAdminUserName StringString
LocalAdminPasswordLocalAdminPassword StringString
NewVirtualNetworkAdapterInputNewVirtualNetworkAdapterInput PSObjectPSObject
LinuxAdministratorSSHKeyLinuxAdministratorSSHKey StringString
LinuxDomainNameLinuxDomainName StringString

Parámetros para un nuevo servicioParameters for a new service


La tabla siguiente muestra los parámetros disponibles cuando se crea un nuevo servicio.The following table lists the parameters available when a new service is created. Todos los parámetros son opcionales a menos que se indique que son necesarios.All parameters are optional unless indicated as required.

ParámetroParameter Tipo de datosData Type
StampID (necesarios)StampID (required) GuidGuid
CloudID (necesarios)CloudID (required) GuidGuid
ServiceTempateIdServiceTempateId GuidGuid
NewServiceDeploymentNewServiceDeployment PSObjectPSObject
IgnorePlacementErrorsIgnorePlacementErrors BooleanBoolean