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:
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" -EnableUm die Einstellung für den erweiterbaren Ereignishandler zu bestimmen, rufen Sie das Cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler auf.
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 |