Share via

Set-SCSPFExtensibleEventHandler

  • Référence
Module:
spfadmin

Définit un gestionnaire d’événements extensible dans Service Provider Foundation.

Syntax

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

Description

L’applet de commande Set-SCSPFExtensibleEventHandler appelle un runbook dans System Center - Orchestrator pour qu’il s’exécute chaque fois qu’une machine virtuelle ou un service est créé. La machine virtuelle ou le service doit être créé par des appels à Service Provider Foundation avec le service Virtual Machine Manager (VMM). Service Provider Foundation déclenche des événements internes pour appeler le runbook, et le runbook est appelé en continu tant que le gestionnaire d’événements extensible est activé.

Service Provider Foundation n’appelle pas le runbook si la machine virtuelle ou le service a été créé par d’autres moyens, par exemple à l’aide d’applets de commande PowerShell pour à l’aide de la console dans VMM.

Pour prendre en charge l’infrastructure d’appel d’un runbook, Service Provider Foundation appelle l’applet de commande Start-SCOrchestratorRunbook en interne ; l’utilisateur n’a pas besoin de l’appeler explicitement.

Exemples

Exemple 1 : Définir un gestionnaire d’événements

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

Cette commande permet à un gestionnaire d’événements d’appeler un runbook.

Exemple 2 : Désactiver un gestionnaire d’événements

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

Cette commande désactive un gestionnaire d’événements d’appeler un runbook, car le paramètre Enable est omis.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Enable

Indique que le gestionnaire d’événements extensible est activé. Omettez ce paramètre pour désactiver le gestionnaire.

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

-EventName

Spécifie VirtualMachineCreated ou ServiceCreated pour l’événement qui appelle un runbook Orchestrator.

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

-OrchestratorUri

Spécifie l’URI du service web Orchestrator tel que spécifié par le fichier web.config dans 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

Spécifie le chemin d’accès à un runbook dans Orchestrator.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

None

Sorties

System.Object