Set-SCSPFExtensibleEventHandler
Legt einen erweiterbaren Ereignishandler in Service Provider Foundation fest.
Syntax
Default (Standardwert)
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 immer dann ausgeführt wird, wenn ein neuer virtueller Computer oder neuer Dienst erstellt wird. Der virtuelle Computer oder Dienst muss durch Aufrufe von Service Provider Foundation mit dem Virtual Machine Manager (VMM)-Dienst 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 die Konsole in VMM.
Um die Infrastruktur für den Aufruf eines Runbooks zu unterstützen, ruft Service Provider Foundation das Cmdlet Start-SCOrchestratorRunbook intern auf. Der Benutzer muss es 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 weggelassen wird.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Enable
Gibt an, dass der erweiterbare Ereignishandler aktiviert ist. Lassen Sie diesen Parameter weg, um den Handler zu deaktivieren.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EventName
Gibt entweder VirtualMachineCreated oder ServiceCreated für das Ereignis an, das ein Orchestrator-Runbook aufruft.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OrchestratorUri
Gibt den URI des Orchestrator-Webdiensts an, der in der web.config Datei unter C:\Programme (x86)\Microsoft System Center 2012\Orchestrator\Orchestration Console angegeben ist.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RunbookPath
Gibt den Pfad zu einem Runbook in Orchestrator an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.