Set-SCSPFExtensibleEventHandler
Définit un gestionnaire d’événements extensible dans Service Provider Foundation.
Syntaxe
Default (Par défaut)
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 s’exécuter chaque fois qu’une machine virtuelle ou un nouveau 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, qui 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’utilisation de la console dans VMM.
Pour prendre en charge l’infrastructure permettant d’appeler 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 empêche un gestionnaire d’événements d’appeler un runbook, car le paramètre Enable est omis.
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Enable
Indique que le gestionnaire d’événements extensible est activé. Omettez ce paramètre pour désactiver le gestionnaire.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EventName
Spécifie VirtualMachineCreated ou ServiceCreated pour l’événement qui appelle un runbook Orchestrator.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RunbookPath
Spécifie le chemin d’accès à un runbook dans Orchestrator.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.