Set-SCSPFExtensibleEventHandler
Ustawia rozszerzalną procedurę obsługi zdarzeń w programie Service Provider Foundation.
Składnia
Set-SCSPFExtensibleEventHandler
-EventName <String>
[-OrchestratorUri <String>]
[-RunbookPath <String>]
[-Enable]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-SCSPFExtensibleEventHandler wywołuje element Runbook w programie System Center — Orchestrator do uruchamiania za każdym razem, gdy zostanie utworzona nowa maszyna wirtualna lub nowa usługa. Maszyna wirtualna lub usługa musi zostać utworzona przez wywołania do programu Service Provider Foundation za pomocą usługi Virtual Machine Manager (VMM). Program Service Provider Foundation zgłasza zdarzenia wewnętrzne w celu wywołania elementu Runbook, a element Runbook będzie wywoływany w sposób ciągły, o ile rozszerzalna procedura obsługi zdarzeń jest włączona.
Program Service Provider Foundation nie wywoła elementu Runbook, jeśli maszyna wirtualna lub usługa została utworzona w inny sposób, na przykład za pomocą poleceń cmdlet programu PowerShell dla programu za pomocą konsoli programu VMM.
Aby obsługiwać infrastrukturę wywoływania elementu Runbook, program Service Provider Foundation wywołuje polecenie cmdlet Start-SCOrchestratorRunbook wewnętrznie; użytkownik nie musi jawnie go wywoływać.
Przykłady
Przykład 1. Ustawianie procedury obsługi zdarzeń
PS C:\>Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "https://scxspf-ws8-24:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable
To polecenie umożliwia program obsługi zdarzeń wywoływanie elementu Runbook.
Przykład 2: Wyłączanie procedury obsługi zdarzeń
PS C:\>Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "https://scxspf-ws8-24:82/Orchestrator2012/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created"
To polecenie wyłącza procedurę obsługi zdarzeń z wywoływania elementu Runbook, ponieważ parametr Enable zostanie pominięty.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Wskazuje, że rozszerzalna procedura obsługi zdarzeń jest włączona. Pomiń ten parametr, aby wyłączyć procedurę obsługi.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EventName
Określa element VirtualMachineCreated lub ServiceCreated dla zdarzenia, które wywołuje element Runbook programu Orchestrator.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OrchestratorUri
Określa identyfikator URI usługi sieci Web programu Orchestrator określony przez plik web.config w folderze C:\Program Files (x86)\Microsoft System Center 2012\Orchestrator\Orchestration Console.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunbookPath
Określa ścieżkę do elementu Runbook w programie Orchestrator.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Dane wyjściowe
System.Object