Automatisieren und Aufrufen von Runbooks über SPF

Wichtig

Diese Version von Service Provider Foundation (SPF) hat das Ende des Supports erreicht. Es wird empfohlen, ein Upgrade auf SPF 2019 durchzuführen.

Sie können System Center Service Provider Foundation (SPF) und Service Management Automation (SMA) zusammen verwenden, um automatisierte Lösungen für Ihre Mandanten bereitzustellen. Sie können Ereignisse in SPF konfigurieren, die vom SMA-Webdienst verwendet werden.

Automatisieren von Runbooks

Sie können Runbooks mit SMA automatisieren, vorausgesetzt, Sie haben SMA für die Verwendung von SPF mithilfe der cmdlets Set-SCSPFEventRegisration und Get-SCSPFEventRegistation konfiguriert. Dies wird im folgenden Beispiel gezeigt:

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"  

Aufrufen von Runbooks

Sie können ein Runbook in System Center – Orchestrator so festlegen, dass es immer ausgeführt wird, wenn ein neuer virtueller Computer oder Dienst durch Remoteaufrufe von SPF mit System Center Virtual Machine Manager (VMM) erstellt wird.

  • Sie können das Runbook so festlegen, dass es mit dem Windows PowerShell T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler-Cmdlet aufgerufen wird.
  • SPF löst interne Ereignisse aus, um das Runbook aufzurufen. Das Runbook wird kontinuierlich aufgerufen, solange der erweiterbare Ereignishandler aktiviert ist.
  • SPF ruft das Runbook nicht auf, wenn die VM oder der Dienst auf andere Weise erstellt wurde. Verwenden Sie beispielsweise Windows PowerShell Cmdlets oder die VMM-Konsole.
  • Um die Infrastruktur zum Aufrufen eines Runbooks zu unterstützen, ruft SPF intern das Cmdlet Start-SCOrchestratorRunbook auf. Er muss nicht explizit vom Benutzer aufgerufen werden.
  • Stellen Sie sicher, dass Sie Folgendes angewendet haben, bevor Sie das Cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler aufrufen:
    • Die URL des Orchestrator-Webdiensts.
    • Die Identitätseinstellungen für die SPF-Anwendungspools im Internetinformationsdienste-Manager (IIS) müssen in der Orchestrator-Benutzergruppe enthalten sein.

Rufen Sie dann ein Runbook wie folgt auf:

  1. Rufen Sie T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler mit folgenden Parametern auf:

    Parameter Wert
    EventName Geben Sie „VirtualMachineCreated“ oder „ServiceCreated“ an.
    OrchestratorUri Der URI für den Orchestrator-Webdienst.
    RunbookPath Der lokale Pfad zum Runbook.
    Aktivieren Geben Sie diesen Parameter an, um das Runbook zu aktivieren.

    Wenn das Runbook nicht aufgerufen werden soll, lassen Sie diesen Parameter aus.

    Beispiel:

    PS C:\> Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "http://east.contoso.com:82/Orchestrator2016/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable  
    
  2. Um die Einstellung für den erweiterbaren Ereignishandler zu bestimmen, rufen Sie das Cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler auf.

  3. Um das Aufrufen eines Runbooks zu deaktivieren, wiederholen Sie den Befehl T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler, jedoch ohne den Enable-Parameter. Sie können auch leere Zeichenfolgen für die Parameter OrchestratorUrl und Runbookpath angeben, wie im folgenden Beispiel gezeigt:

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

Runbookparameter

Diese Liste von Parametern wird automatisch für das Runbook bereitgestellt. Ein Runbook muss nicht alle empfangenen Parameter verarbeiten. Parameter, die keinen Zweck im Runbook haben, werden ignoriert.

Parameter für einen neuen virtuellen Computer

In der folgenden Tabelle sind die Parameter aufgeführt, die beim Erstellen eines neuen virtuellen Computers verfügbar sind. Alle Parameter sind optional, sofern nicht angegeben.

Parameter Datentyp
StampID (erforderlich) Guid
Name (StampID-Name – erforderlich) Zeichenfolge
CloudID (erforderlich) Guid
VMTemplateID Guid
HardwareProfileID Guid
VirtualHardDiskID Guid
BESCHREIBUNG String
CostCenter Zeichenfolge
Tag Zeichenfolge
Computername String
BlockDynamicOptimization Boolean
CPULimitForMigration Boolean
CPULimitFunctionality Boolean
CPURelativeWeight Int32
DelayStartSeconds Int32
Domain Zeichenfolge
UserName Zeichenfolge
Kennwort Zeichenfolge
DynamicMemoryBufferPercentage Int32
DynamicMemoryEnabled Boolean
DynamicMemoryMaximumMB Int32
FullName Zeichenfolge
Arbeitsspeicher Int32
MemoryWeight Int32
OrganizationName Zeichenfolge
StartAction Zeichenfolge
StartVM Boolean
StopAction Zeichenfolge
CPUCount Byte
Besitzer PSObject
ProductKey Zeichenfolge
WorkGroup Zeichenfolge
TimeZone Int32
RunAsAccountUserName Zeichenfolge
LocalAdminRunAsAccountName Zeichenfolge
LocalAdminUserName Zeichenfolge
LocalAdminPassword Zeichenfolge
NewVirtualNetworkAdapterInput PSObject
LinuxAdministratorSSHKey Zeichenfolge
LinuxDomainName Zeichenfolge

Parameter für einen neuen Dienst

In der folgende Tabelle werden die verfügbaren Parameter beim Erstellen eines neuen Diensts aufgelistet. Alle Parameter sind optional, sofern nicht angegeben.

Parameter Datentyp
StampID (erforderlich) Guid
CloudID (erforderlich) Guid
ServiceTemplateID Guid
NewServiceDeployment PSObject
IgnorePlacementErrors Boolean