Delen via

Set-SCSPFExtensibleEventHandler

  • Referentie
Module:
spfadmin

Hiermee stelt u een uitbreidbare gebeurtenis-handler in Service Provider Foundation.

Syntax

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

Description

De cmdlet Set-SCSPFExtensibleEventHandler roept een runbook in System Center - Orchestrator aan om uit te voeren wanneer er een nieuwe virtuele machine of nieuwe service wordt gemaakt. De virtuele machine of service moet worden gemaakt door aanroepen naar Service Provider Foundation met de VMM-service (Virtual Machine Manager). Service Provider Foundation genereert interne gebeurtenissen om het runbook aan te roepen en het runbook wordt continu aangeroepen zolang de uitbreidbare gebeurtenis-handler is ingeschakeld.

Service Provider Foundation roept het runbook niet aan als de virtuele machine of service op een andere wijze is gemaakt, zoals met behulp van PowerShell-cmdlets voor met behulp van de -console in VMM.

Ter ondersteuning van de infrastructuur voor het aanroepen van een runbook roept Service Provider Foundation de Start-SCOrchestratorRunbook-cmdlet intern aan; de gebruiker hoeft deze niet expliciet aan te roepen.

Voorbeelden

Voorbeeld 1: Een gebeurtenis-handler instellen

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

Met deze opdracht kan een gebeurtenis-handler een runbook aanroepen.

Voorbeeld 2: Een gebeurtenis-handler uitschakelen

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

Met deze opdracht wordt voorkomen dat een gebeurtenis-handler een runbook aanroept omdat de parameter Enable wordt weggelaten.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Enable

Geeft aan dat de uitbreidbare gebeurtenis-handler is ingeschakeld. Laat deze parameter weg om de handler uit te schakelen.

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

-EventName

Hiermee geeft u VirtualMachineCreated of ServiceCreated op voor de gebeurtenis die een Orchestrator-runbook aanroept.

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

-OrchestratorUri

Hiermee geeft u de URI van de Orchestrator-webservice op zoals opgegeven door het web.config-bestand in 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

Hiermee geeft u het pad naar een runbook in Orchestrator.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

None

Uitvoerwaarden

System.Object