Freigeben über

Set-SCSPFExtensibleEventHandler

  • Referenz
Modul:
spfadmin

Legt einen erweiterbaren Ereignishandler in Service Provider Foundation fest.

Syntax

Set-SCSPFExtensibleEventHandler
   -EventName <String>
   [-OrchestratorUri <String>]
   [-RunbookPath <String>]
   [-Enable]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCSPFExtensibleEventHandler ruft ein Runbook in System Center – Orchestrator auf, das bei der Erstellung eines neuen virtuellen Computers oder eines neuen Diensts ausgeführt wird. Der virtuelle Computer oder Dienst muss durch Aufrufe von Service Provider Foundation mit dem VMM-Dienst (Virtual Machine Manager) erstellt werden. Service Provider Foundation löst interne Ereignisse aus, um das Runbook aufzurufen, und das Runbook wird kontinuierlich aufgerufen, solange der erweiterbare Ereignishandler aktiviert ist.

Service Provider Foundation ruft das Runbook nicht auf, wenn der virtuelle Computer oder Dienst auf andere Weise erstellt wurde, z. B. mithilfe von PowerShell-Cmdlets für mithilfe der Konsole in VMM.

Um die Infrastruktur für das Aufrufen eines Runbooks zu unterstützen, ruft Service Provider Foundation das Cmdlet Start-SCOrchestratorRunbook intern auf. Der Benutzer muss ihn nicht explizit aufrufen.

Beispiele

Beispiel 1: Festlegen eines Ereignishandlers

PS C:\>Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "https://scxspf-ws8-24:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable

Mit diesem Befehl kann ein Ereignishandler ein Runbook aufrufen.

Beispiel 2: Deaktivieren eines Ereignishandlers

PS C:\>Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "https://scxspf-ws8-24:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created"

Mit diesem Befehl wird verhindert, dass ein Ereignishandler ein Runbook aufruft, da der Parameter Enable ausgelassen wird.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enable

Gibt an, dass der erweiterbare Ereignishandler aktiviert ist. Lassen Sie diesen Parameter weg, um den Handler zu deaktivieren.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventName

Gibt entweder VirtualMachineCreated oder ServiceCreated für das Ereignis an, das ein Orchestrator-Runbook aufruft.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OrchestratorUri

Gibt den URI des Orchestrator-Webdiensts an, der in der web.config-Datei in C:\Programme (x86)\Microsoft System Center 2012\Orchestrator\Orchestration Console angegeben wird.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunbookPath

Gibt den Pfad zu einem Runbook in Orchestrator an.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Object