Automatisieren eines Runbooks aus Service Provider Foundation

Veröffentlicht: Juli 2016

Gilt für: System Center 2012 SP1 - Orchestrator, System Center 2012 R2 Orchestrator

Ab Service Provider FoundationSystem Center 2012 R2 können Sie Service Management-Automatisierung für die Verwendung von Service Provider Foundation konfigurieren. Weitere Informationen finden Sie unter Verwalten von Webdiensten und Verbindungen in Service Provider Foundation im Abschnitt „Verbinden mit dem SMA-Webdienst“. Sie können zum Aufrufen von Runbooks auch das ältere Szenario „Runbook aufrufen“ verwenden.

Sie können Runbooks mit Service Management Automation automatisieren, sofern Sie Service Management-Automatisierung für die Verwendung von Service Provider Foundation konfigurieren. Verwenden Sie hierfür die Cmdlets „Set-SCSPFEventRegisration“ und „Get-SCSPFEventRegistation“, wie 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"  
  

Im weiteren Verlauf dieses Themas wird das ältere Szenario beschrieben.

Sie können festlegen, dass ein Runbook in System Center 2012 – Orchestrator ausgeführt wird, sobald eine neue virtuelle Maschine oder ein neuer Dienst durch Remoteaufrufe an Service Provider Foundation mit dem Virtual Machine Manager Service erstellt wird. Sie können mit dem Windows PowerShell-Cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler festlegen, dass das Runbook aufgerufen wird. In Service Provider Foundation werden interne Events ausgelöst, um das Runbook aufzurufen. Das Runbook wird kontinuierlich aufgerufen, solange der erweiterbare Ereignishandler aktiviert ist.

Das Runbook wird in Service Provider Foundation nicht aufgerufen, wenn die virtuelle Maschine oder der Service mithilfe anderer Methoden erstellt wurde, z. B. mit Windows PowerShell-Cmdlets oder mit der Konsole in System Center 2012 – Virtual Machine Manager (VMM).

Damit die Unterstützung der Infrastruktur zum Aufrufen eines Runbooks gewährleistet ist, wird das Cmdlet Service Provider Foundation intern in Start-SCOrchestratorRunbook aufgerufen und muss nicht explizit durch den Benutzer aufgerufen werden.

Stellen Sie sicher, dass Sie die folgenden Informationen und Einstellungen zugewiesen haben, bevor Sie das Cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler aufrufen:

• URI des Orchestrator-Webdiensts.

• Die Identitätseinstellungen für die Service Provider Foundation-Anwendungspools in Internet Information Services (IIS) Manager müssen in der Orchestrator-Benutzergruppe enthalten sein. Informationen zum Ermitteln der für Service Provider Foundation zugewiesenen Anmeldeinformationen finden Sie unter Verify local user credentials for portal access im Abschnitt „Überprüfen der Anmeldeinformationen des lokalen Benutzers für den Portalzugriff“. Informationen zum Hinzufügen von Anmeldeinformationen zur Orchestrator-Benutzergruppe finden Sie unter Ändern der Orchestrator-Benutzergruppe.

Eine Liste der Parameter, die dem Runbook automatisch übergeben werden, finden Sie unter Parameter für aus Service Provider Foundation aufgerufene Runbooks.

So rufen Sie ein Runbook von Service Provider Foundation auf

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

  Parameter	Wert
  EventName	Geben Sie „VirtualMachineCreated“ oder „ServiceCreated“ an.
  OrchestratorUri	URI des Orchestrator-Webdiensts.
  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/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable  
  

Um die Einstellungen des erweiterbaren Ereignishandlers zu bestimmen, rufen Sie das Cmdlet T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler auf.

So deaktivieren Sie den Aufruf eines Runbooks

• Wiederholen Sie den Befehl T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler, lassen Sie jedoch den Parameter Enable aus. Sie können für die Parameter OrchestratorUri und Runbookpath auch leere Zeichenfolgen angeben, wie im folgenden Beispiel gezeigt:

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

Verwalten von Webdiensten und Verbindungen in Service Provider Foundation
Parameter für aus Service Provider Foundation aufgerufene Runbooks
Erweiterbarkeit in Service Provider Foundation
Verwalten von Service Provider Foundation
Cmdlets in System Center 2012 – Service Provider Foundation
Orchestrator-Webdienst zur Verwendung von HTTPS konfigurieren.