Automatización e invocación de runbooks desde SPF

  • Artículo

Importante

Esta versión de Service Provider Foundation (SPF) ha alcanzado el final del soporte técnico; se recomienda actualizar a SPF 2022.

Puede usar System Center - Service Provider Foundation (SPF) y Service Management Automation (SMA) juntos para proporcionar soluciones automatizadas para los inquilinos. Puede configurar eventos en SPF que usa el servicio web SMA.

Automatizar runbooks

Puede automatizar runbooks mediante SMA, si ha configurado SMA para usar SPF, mediante los Set\-SCSPFEventRegisration and Get\-SCSPFEventRegistation cmdlets . Esto se muestra en el ejemplo siguiente:

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"

Invocación de runbooks

Puede establecer un runbook en System Center - Orchestrator para que se ejecute cada vez que se cree una nueva máquina virtual o servicio mediante llamadas remotas a SPF con System Center - Virtual Machine Manager (VMM).

  • Puede establecer el runbook que se va a invocar mediante el cmdlet Windows PowerShellT:Microsoft.SystemCenter.Foundation.Cmdlet.Set\-SCSPFExtensibleEventHandler.
  • SPF genera eventos internos para invocar el runbook. El runbook se invoca continuamente si el controlador de eventos extensible está habilitado.
  • SPF no invocará el runbook si la máquina virtual o el servicio se creó por otros medios. Por ejemplo, mediante cmdlets de Windows PowerShell o mediante la consola VMM.
  • Para admitir la infraestructura para invocar un runbook, SPF llama al Start-SCOrchestratorRunbook cmdlet internamente. No es necesario llamar explícitamente al usuario.
  • Asegúrese de que ha aplicado lo siguiente antes de llamar al T:Microsoft.SystemCenter.Foundation.Cmdlet.Set\-SCSPFExtensibleEventHandler cmdlet :
    • Dirección URL del servicio web orchestrator.
    • La configuración de identidad de los grupos de aplicaciones SPF en el Administrador de Internet Information Services (IIS) debe incluirse en el grupo de usuarios de Orchestrator.

A continuación, invoque un runbook de la siguiente manera:

  1. T:Microsoft.SystemCenter.Foundation.Cmdlet.Set\-SCSPFExtensibleEventHandler Llame a con los parámetros siguientes:

    Parámetro Valor
    EventName Especifique "VirtualMachineCreated" o "ServiceCreated".
    OrchestratorUri Identificador URI del servicio web orchestrator.
    RunbookPath La ruta de acceso local al Runbook.
    Habilitar Especifique este parámetro para habilitar el Runbook.

    Para deshabilitar la invocación del Runbook, ignore este parámetro.

    Ejemplo:

    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 la configuración del controlador de eventos extensible, llame al T:Microsoft.SystemCenter.Foundation.Cmdlet.Get\-SCSPFExtensibleEventHandler cmdlet .

  3. Para deshabilitar que se invoque un runbook, repita el T:Microsoft.SystemCenter.Foundation.Cmdlet.Get\-SCSPFExtensibleEventHandler comando, pero sin el parámetro Enable . También puede especificar cadenas vacías para los parámetros OrchestratorUrl y Runbookpath , como se muestra en el ejemplo siguiente:

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

Parámetros de runbook

Esta lista de parámetros se proporciona automáticamente al runbook. Un runbook no necesita procesar todos los parámetros que recibe. Omite los parámetros que no tienen ningún propósito en el runbook.

Parámetros de una nueva máquina virtual

En la tabla siguiente se enumeran los parámetros disponibles cuando se crea una nueva máquina virtual. Todos los parámetros son opcionales a menos que se indique.

Parámetro Tipo de datos
StampId (obligatorio) Guid
Nombre (nombre stampID: obligatorio) String
CloudId (obligatorio) Guid
VMTemplateId Guid
HardwareProfileId Guid
VirtualHardDiskId Guid
Descripción String
CostCenter String
Etiqueta String
ComputerName String
BlockDynamicOptimization Boolean
CPULimitForMigration Boolean
CPULimitFunctionality Boolean
CPURelativeWeight Int32
DelayStartSeconds Int32
Dominio String
UserName String
Contraseña String
DynamicMemoryBufferPercentage Int32
DynamicMemoryEnabled Boolean
DynamicMemoryMaximumMB Int32
FullName String
Memoria Int32
MemoryWeight Int32
OrganizationName String
StartAction String
StartVM Boolean
StopAction String
CPUCount Byte
Propietario PSObject
ProductKey String
WorkGroup String
TimeZone Int32
RunAsAccountUserName String
LocalAdminRunAsAccountName String
LocalAdminUserName String
LocalAdminPassword String
NewVirtualNetworkAdapterInput PSObject
LinuxAdministratorSSHKey String
LinuxDomainName String

Parámetros para un nuevo servicio

La tabla siguiente muestra los parámetros disponibles cuando se crea un nuevo servicio. Todos los parámetros son opcionales a menos que se indique.

Parámetro Tipo de datos
StampId (obligatorio) Guid
CloudId (obligatorio) Guid
ServiceTempateId Guid
NewServiceDeployment PSObject
IgnorePlacementErrors Boolean