Informations de référence sur l’activité de workflow de l’outil de création Service Manager

Cet article fournit des conseils pour les développeurs informatiques afin qu’ils puissent créer des activités Windows Workflow Foundation (WF) personnalisées que les professionnels de l’informatique peuvent utiliser pour créer des flux de travail WF spécifiques à leurs processus informatiques. Les activités WF personnalisées étendent la bibliothèque d’activités , les activités distribuées avec l’outil de création Service Manager. La section Référence des activités de flux de travail de ce document fournit des détails sur les activités WF par défaut dans la bibliothèque d'activités. Ces informations visent à aider les développeurs (ou les professionnels de l'informatique agissant en tant que développeurs) à créer des activités WF personnalisées, en fonction des besoins.

Pour plus d’informations sur l’utilisation des activités WF et des flux de travail WF avec Service Manager, consultez Automatisation des processus informatiques avec des flux de travail.

Activités Active Directory

Utilisez des activités services de domaine Active Directory (AD DS) pour faire en sorte que les fonctions Active Directory fassent partie de votre flux de travail dans Service Manager.

L’outil de création Service Manager fournit deux activités Service Manager par défaut dans le groupe Activités Active Directory dans le volet Boîte à outils Activités. Les sections de cet article décrivent ces activités.

Ajouter un ordinateur AD DS à une activité de groupe

Cette activité ajoute un ordinateur à un groupe de sécurité dans services de domaine Active Directory (AD DS) dans Service Manager. L’ordinateur et le groupe doivent appartenir au même domaine, et tous les conteneurs du domaine sont recherchés.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	Lorsque vous utilisez cette activité, vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans AD DS.

Propriétés

L’activité Ajouter un ordinateur AD DS au groupe utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Domaine de l’ordinateur	ComputerDomain	Chaîne	Oui	Nom de domaine DNS complet où se trouve l’ordinateur (par exemple, contoso.com).
Nom d’ordinateur	FullyQualifiedComputerName	Chaîne	Oui	Nom de l'ordinateur.
Nom du groupe	FullyQualifiedGroupName	Chaîne	Oui	Nom du groupe services de domaine Active Directory.

L’activité Ajouter un ordinateur AD DS au groupe génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Description
Sortie	Sortie	Boolean	Résultat de l’opération : True si l’ajout a réussi ; False s’il a échoué.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	None	None

Ajouter un utilisateur AD DS à l’activité de groupe

Cette activité ajoute un utilisateur à un groupe de sécurité dans services de domaine Active Directory (AD DS) dans Service Manager. L’utilisateur et le groupe doivent appartenir au même domaine, et tous les conteneurs du domaine sont recherchés.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	Lorsque vous utilisez cette activité, vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans AD DS.

Propriétés

L’activité Ajouter un utilisateur AD DS au groupe utilise les propriétés d’entrée répertoriées dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Domaine de l’utilisateur	UserDomain	Chaîne	Oui	Nom de domaine complet (FQDN) de l’utilisateur.
Nom d’utilisateur	UserName	Chaîne	Oui	Nom de connexion de l’utilisateur.
Nom du groupe	FullyQualifiedGroupName	Chaîne	Oui	Nom de domaine complet du groupe.

L’activité Ajouter un utilisateur AD DS au groupe génère la sortie décrite dans le tableau suivant.

Nom d’affichage	Nom interne	Type	Description
Sortie	Sortie	Boolean	Résultat de l’opération : True si l’ajout a réussi, False s’il a échoué.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	None	None

Activités de flux de contrôle

Utilisez les activités de flux de contrôle pour fournir une structure ( branches, boucles ou retards du minuteur) pour votre flux de travail dans Service Manager.

L’outil de création fournit quatre activités de flux de contrôle par défaut dans le groupe Flux de contrôle dans le volet Boîte à outils Activités.

Retarder l’activité

Cette activité introduit un délai entre les activités d’un flux de travail dans Service Manager. L’activité Delay est dérivée de la classe Microsoft .NET Framework DelayActivity .

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité Delay utilise les propriétés d’entrée répertoriées dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Initialiser timeoutDuration	InitializeTimeoutDuration		Interne	Spécifie un gestionnaire pour initialiser la propriété TimeoutDuration .
TimeoutDuration	TimeoutDuration	Timespan	Oui	Durée du délai.

L’activité Delay ne produit pas de propriété de sortie.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	Pour plus d’informations sur cette activité, consultez La classe DelayActivity dans la bibliothèque de classes .NET Framework.	Aucun(e)

Activité For Each Loop

L’activité For Each Loop prend comme entrée un tableau (collection) d’objets et répète l’ensemble d’activités dans la boucle pour chaque objet de la collection. Par exemple, si la collection d’entrée a cinq objets, la boucle itère cinq fois. Si la collection est vide, la boucle n’effectue pas d’itération. Il n’existe aucune limite supérieure au nombre d’objets de la collection. L’activité For Each Loop s’exécute toujours sur l’ordinateur sur lequel le flux de travail s’exécute.

L’activité For Each Loop est une activité composite avec deux conteneurs pour les activités :

• Conteneur d’entrée : cette activité configure la boucle et définit la collection d’entrée. Vous pouvez utiliser l’activité Get Incident ou Get Virtual Machine dans ce rôle.

• Conteneur de boucles : Nommé ForEachChildActivity, cette activité contient les activités de boucle. La plupart des activités Windows Workflow Foundation (WF) que vous placez dans ce conteneur ont deux propriétés supplémentaires : Élément actuel et Propriété à lier. Pour chaque activité dans le conteneur de boucles, définissez ces propriétés comme suit :

  1. Définissez l’élément actif sur la propriété Élément actuel de l’activité conteneur de boucles de l’activité ForEach . Si cette activité est la première activité de l’activité For Each Loop , l’élément actif est défini automatiquement.

  2. Définissez la valeur de la propriété sur Lier la propriété à la valeur de la propriété de l’activité actuelle qui utilise la valeur Élément actuel.

Deux types d’activités n’obtiennent pas les propriétés Current Item et Property to Bind et ne peuvent donc pas utiliser les objets de la collection d’entrée :

• Activités de script, telles que l’activité script Windows PowerShell.

• Activités personnalisées ou autres activités qui n’héritent pas de la classe WorkflowActivityBase . Ces activités incluent ces activités basées sur la classe de base d’activités , telles que les activités Visual Studio natives.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité For Each Loop utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Collection d’entrée	InputCollection	Array/Object	N/A	Collection d’objets à passer, une à la fois, aux activités de l’activité For Each Loop . Si l’activité qui réside dans le conteneur d’entrée produit un tableau d’objets en tant que propriété de sortie, la collection d’entrée est automatiquement définie sur cette propriété. Pour afficher la valeur actuelle de cette propriété, cliquez avec le bouton droit sur le conteneur de boucles, puis sélectionnez Propriétés.
Élément actuel	CurrentItem	Object	N/A	Index dans la collection d’entrée que les activités de la boucle peuvent utiliser comme propriété d’entrée. Pour la première activité dans le conteneur de boucles, cette propriété est définie automatiquement.

Erreurs et exceptions	Notes	Exemple
L’activité For Each Loop utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions dans les conditions suivantes : - Si une erreur se produit dans l’activité ForEachLoop et que ce n’est pas le cas avec les activités enfants, le flux de travail se termine. - Si une erreur se produit dans les activités enfants, le flux de travail se termine sauf si ContinueOnError=true. - Si l’une des propriétés d’entrée est null. L’activité n’effectue pas d’itération. Chaque activité dans l’activité For Each Loop doit écrire ses propres erreurs ou exceptions dans le service de suivi personnalisé. L’activité For Each Loop ne le fait pas elle-même.	Aucun(e)	None

Activité IfElse

Cette activité contrôle la séquence d’activités au sein d’un flux de travail en fonction d’une condition booléenne (True/False). Vous pouvez utiliser le résultat d’une activité précédente, telle qu’une activité de script, pour la condition.

L’activité IfElse est une activité Visual Studio qui utilise des règles et des conditions. Pour plus d’informations sur l’utilisation de règles et de conditions dans Windows Workflow Foundation (WF), consultez Tutoriel : Utiliser des règles et des conditions dans WF dans MSDN Library.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

Aucune.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	Pour plus d’informations sur l’activité IfElse , consultez La classe IfElseActivity dans la bibliothèque de classes .NET Framework 4.	Aucun(e)

Activité parallèle

Cette activité fourche la séquence d’activités en deux séquences simultanées d’activités. L’activité Parallèle est une activité Visual Studio. Pour plus d’informations sur la classe ParallelActivity , consultez La classe ParallelActivity dans la bibliothèque de classes .NET Framework.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

Aucune.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	None	None

Activités virtual Machine Manager

Utilisez les activités de gestion des machines virtuelles dans Service Manager pour créer et mettre à jour des flux de travail qui permettent de créer et de mettre à jour des machines virtuelles. Les activités de gestion des machines virtuelles prennent en charge System Center Virtual Machine Manager.

L’outil de création Service Manager fournit les cinq activités de gestion des machines virtuelles par défaut suivantes dans le groupe Activités VMM dans le volet Boîte à outils Activités.

Obtenir l’activité de machine virtuelle

Cette activité dans Service Manager récupère une liste d’un ou plusieurs ID de machine virtuelle à partir d’une bibliothèque VMM (Virtual Machine Manager).

Conditions préalables au temps de conception

Conditions préalables à l’exécution

Aucun(e)

- La console Virtual Machine Manager et Service Manager doivent être installés sur le même serveur. - Vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans services de domaine Active Directory (AD DS). - La console Virtual Machine Manager et Service Manager doivent être installés sur le même serveur. - Vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans services de domaine Active Directory (AD DS).

Propriétés

L’activité Obtenir une machine virtuelle utilise les propriétés d’entrée dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Jeu de paramètres	ParameterSet	Chaîne	Non; la valeur par défaut est Connexion.	Spécifie un sous-ensemble de paramètres organisés à des fins particulières. Pour l’activité Obtenir une machine virtuelle , vous pouvez sélectionner l’un des ensembles de paramètres suivants : - Tout : recherchez toutes les machines virtuelles disponibles. - ID : recherchez une machine virtuelle avec un ID connu. - Connexion : recherchez des machines virtuelles connectées au serveur Virtual Machine Manager (VMM) désigné par la propriété VMMServer . - VMHostGroup : recherchez les machines virtuelles connectées à l’hôte de machine virtuelle désignée par la propriété Hôte de machine virtuelle.
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Tous	Tous	Boolean	Non. (Le paramètre par défaut est True.)	Disponible si le jeu de paramètres est Tout. S’il est défini sur True, l’activité Obtenir une machine virtuelle retourne une liste des ID de machine virtuelle de toutes les machines virtuelles disponibles.
id	id	Chaîne	Obligatoire si le jeu de paramètres est ID.	Disponible si le jeu de paramètres est ID. S’il est défini sur True, l’activité Obtenir une machine virtuelle retourne une liste des ID de machine virtuelle de toutes les machines virtuelles dont les ID de machine virtuelle correspondent à toutes ou partie de la valeur d’ID spécifiée.
Groupe d’administration	ManagementGroup	Chaîne	Non	Spécifie le groupe d’administration dans lequel cette activité s’exécutera. Défini sur localhost. (Lecture seule)
Serveur de script	Cible	Chaîne	Oui	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution de l’activité.
Hôte de machine virtuelle	VMHost	Chaîne	Obligatoire si le jeu de paramètres est VMHostGroup	Disponible si le jeu de paramètres est VMHostGroup. Si cet ensemble de paramètres est sélectionné, l’activité Obtenir une machine virtuelle retourne une liste des ID de machine virtuelle de toutes les machines virtuelles exécutées sur l’hôte spécifié.
Nom de la machine virtuelle	VMName	Chaîne	Non	Spécifie le nom ou la partie d’un nom de la machine virtuelle à rechercher. Si la chaîne fait partie d’un nom, l’activité récupère les ID de toutes les machines virtuelles qui contiennent la chaîne.
VMMServer	VMMServer	Chaîne	Oui	Spécifie le nom du serveur System Center Virtual Machine Manager (VMM) qui gère les machines virtuelles.

L’activité Obtenir une machine virtuelle génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Commentaires
ID de machine virtuelle	VMIDList	Tableau de chaînes	Spécifie la liste des ID des machines virtuelles avec des noms qui correspondent à toutes ou partie de la chaîne nom de machine virtuelle.

Erreurs et exceptions	Notes	Exemple
L’activité Obtenir une machine virtuelle utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Aucun(e)	None

Déplacer l’activité de machine virtuelle

Cette activité dans Service Manager déplace une machine virtuelle de la bibliothèque VMM (Virtual Machine Manager) vers un hôte de maintenance.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	- La console Virtual Machine Manager et Service Manager doivent être installés sur le même serveur. - Vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans services de domaine Active Directory (AD DS).

Propriétés

L’activité Déplacer une machine virtuelle utilise les propriétés d’entrée du tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Bloquer LM si l’hôte est occupé	BlockLMIfHostBusy	Boolean	Non. (Le paramètre par défaut est False.)	Bloque la nouvelle tentative d’une migration dynamique Hyper-V si la migration a échoué, car l’hôte source ou l’hôte de destination participe déjà à une autre migration dynamique.
Groupe de travaux	JobGroup	Guid (chaîne)	Non	Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu.
Variable de travail	JobVariable	Chaîne	Non	Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
Groupe d’administration	ManagementGroup	Chaîne	Non	Spécifie le groupe d’administration dans lequel cette activité s’exécutera. Défini sur localhost. (Lecture seule)
Chemin d’accès	Chemin d’accès	Chaîne	Non	Spécifie la destination de la machine virtuelle sur l’hôte de maintenance.
PROTipID	PROTipID	Guid	Non	Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (PRO) qui a déclenché cette action. Permet l’audit futur des conseils PRO.
Exécuter de manière asynchrone	RunAsynchronously	Boolean	Non. (Le paramètre par défaut est False.)	Spécifie que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
Serveur de script	Cible	Chaîne	Oui	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution de l’activité.
Démarrer une machine virtuelle sur la cible	StartVMOnTarget	Boolean	Non. (Le paramètre par défaut est False.)	Spécifie qu’une machine virtuelle démarre dès qu’elle atteint son hôte de destination.
Utiliser un cluster	UseCluster	Boolean	Non. (Le paramètre par défaut est False.)	Force l’utilisation de la migration de cluster Windows Server 2008 pour le transfert d’une machine virtuelle dans un état enregistré vers un hôte, même si le cluster prend en charge la migration dynamique Hyper-V.
Utiliser le réseau local	UseLan	Boolean	Non. (Le paramètre par défaut est False.)	Force un transfert sur le réseau local (LAN) même si un mécanisme de transfert plus rapide, tel qu’un transfert SAN (Storage Area Network), est disponible.
Hôte de machine virtuelle	VMHostName	Chaîne	Oui	Spécifie le nom de l’hôte de maintenance vers lequel la machine virtuelle sera déplacée.
ID de l'ordinateur virtuel	VMID	Chaîne	Oui	Spécifie l’ID unique de la machine virtuelle à déplacer.
Serveur VMM	VMMServer	Chaîne	Oui	Spécifie le nom du serveur System Center Virtual Machine Manager (VMM) qui gère les machines virtuelles.

L’activité Déplacer une machine virtuelle génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Commentaires
ID de l'ordinateur virtuel	VMID	Chaîne	Spécifie l’ID unique de la machine virtuelle déplacée. L’ID de machine virtuelle d’entrée et l’ID de machine virtuelle de sortie sont égaux, sauf si l’activité n’a pas pu trouver une machine virtuelle avec un ID de machine virtuelle qui correspond à l’ID de machine virtuelle d’entrée. Dans ce cas, l’ID de machine virtuelle de sortie est défini sur Null.

Erreurs et exceptions	Notes	Exemple
L’activité Déplacer une machine virtuelle utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Aucun(e)	None

Arrêt de l’activité de machine virtuelle

Cette activité dans Service Manager arrête le système d’exploitation invité sur une machine virtuelle.

Vous pouvez utiliser l’activité de machine virtuelle d’arrêt sur une machine virtuelle sur un hôte Windows (hôte Hyper-V ou hôte de serveur virtuel) uniquement si les services invités de virtualisation sont installés sur la machine virtuelle. Pour une machine virtuelle déployée sur un hôte Hyper-V, le service invité de virtualisation est appelé Composants d’intégration. Pour une machine virtuelle déployée sur un hôte de serveur virtuel, le service invité de virtualisation est appelé Ajouts de machines virtuelles.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	- La console Virtual Machine Manager et Service Manager doivent être installés sur le même serveur. - Vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans services de domaine Active Directory (AD DS).

Propriétés

L’activité de machine virtuelle d’arrêt utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Variable de travail	JobVariable	Chaîne	Non	Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
Groupe d’administration	ManagementGroup	Chaîne	Non	Spécifie le groupe d’administration dans lequel cette activité s’exécutera. Défini sur localhost. (Lecture seule)
PROTipID	PROTipID	Guid	Non	Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (PRO) qui a déclenché cette action. Permet l’audit futur des conseils PRO.
Exécuter de manière asynchrone	RunAsynchronously	Boolean	Non. (Le paramètre par défaut est False.)	Spécifie que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
Serveur de script	Cible	Chaîne	Oui	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas Localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution de l’activité.
ID de l'ordinateur virtuel	VMID	Chaîne	Oui	Spécifie l’ID unique de la machine virtuelle à arrêter.
VMMServer	VMMServer	Chaîne	Oui	Spécifie le nom du serveur System Center Virtual Machine Manager (VMM) qui gère les machines virtuelles.

L’activité de machine virtuelle d’arrêt génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Commentaires
ID de l'ordinateur virtuel	VMID	Chaîne	Spécifie l’ID unique de la machine virtuelle qui a été arrêtée. L’ID de machine virtuelle d’entrée et l’ID de machine virtuelle de sortie sont égaux, sauf si l’activité n’a pas pu trouver une machine virtuelle avec un ID de machine virtuelle qui correspond à l’ID de machine virtuelle d’entrée. Dans ce cas, l’ID de machine virtuelle de sortie est défini sur Null.

Erreurs et exceptions	Notes	Exemple
L’activité de machine virtuelle d’arrêt utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Aucun(e)	None

Démarrer l’activité de machine virtuelle

Cette activité dans Service Manager démarre une machine virtuelle arrêtée ou suspendue.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité démarrer la machine virtuelle utilise les propriétés d’entrée dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Variable de travail	JobVariable	Chaîne	Non	Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
Groupe d’administration	ManagementGroup	Chaîne	Non	Groupe d’administration dans lequel cette activité s’exécutera. Défini sur localhost. (Lecture seule)
PROTipID	PROTipID	Guid	Non	Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (PRO) qui a déclenché cette action. Permet l’audit futur des conseils PRO.
Exécuter de manière asynchrone	RunAsynchronously	Boolean	Non. (Le paramètre par défaut est False.)	Spécifie que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
Serveur de script	Cible	Chaîne	Oui	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution de l’activité.
ID de l'ordinateur virtuel	VMID	Chaîne	Oui	Spécifie l’ID unique de la machine virtuelle à démarrer.
VMMServer	VMMServer	Chaîne	Oui	Spécifie le nom du serveur System Center Virtual Machine Manager (VMM) qui gère les machines virtuelles.

L’activité démarrer la machine virtuelle génère la sortie décrite dans le tableau suivant.

Nom d’affichage	Nom interne	Type	Commentaires
ID de l'ordinateur virtuel	VMID	Chaîne	Spécifie l’ID unique de la machine virtuelle démarrée. L’ID de machine virtuelle d’entrée et l’ID de machine virtuelle de sortie sont égaux, sauf si l’activité n’a pas pu trouver une machine virtuelle avec un ID de machine virtuelle qui correspond à l’ID de machine virtuelle d’entrée. Dans ce cas, l’ID de machine virtuelle de sortie est défini sur Null.

Erreurs et exceptions	Notes	Exemple
L’activité démarrer la machine virtuelle utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions, le cas échéant, si l’une des propriétés du script ne peut pas être résolue.	Aucun(e)	None

Enregistrer l’activité de machine virtuelle d’état

Cette activité dans Service Manager enregistre l’état d’une machine virtuelle, puis arrête la machine virtuelle.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	- La console Virtual Machine Manager et Service Manager doivent être installés sur le même serveur. - Vérifiez que le compte de flux de travail Service Manager dispose des autorisations suffisantes pour modifier les groupes de sécurité dans services de domaine Active Directory (AD DS).

Propriétés

L’activité de machine virtuelle Save State utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Variable de travail	JobVariable	Chaîne	Non	Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
Groupe d’administration	ManagementGroup	Chaîne	Non	Spécifie le groupe d’administration dans lequel cette activité s’exécutera. Défini sur localhost. (Lecture seule)
PROTipID	PROTipID	Guid	Non	Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (PRO) qui a déclenché cette action. Permet l’audit futur des conseils PRO.
Exécuter de manière asynchrone	RunAsynchronously	Boolean	Non. (Le paramètre par défaut est False.)	Spécifie que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
Serveur de script	Cible	Chaîne	Oui	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution de l’activité.
ID de l'ordinateur virtuel	VMID	Chaîne	Oui	Spécifie l’ID unique de la machine virtuelle à enregistrer.
Serveur VMM	VMMServer	Chaîne	Oui	Spécifie le nom du serveur System Center Virtual Machine Manager (VMM) qui gère les machines virtuelles.

L’activité Enregistrer l’état de la machine virtuelle génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Commentaires
ID de l'ordinateur virtuel	VMID	Chaîne	Spécifie l’ID unique de la machine virtuelle qui a été enregistrée. L’ID de machine virtuelle d’entrée et l’ID de machine virtuelle de sortie sont égaux, sauf si l’activité n’a pas pu trouver une machine virtuelle avec un ID de machine virtuelle qui correspond à l’ID de machine virtuelle d’entrée. Dans ce cas, l’ID de machine virtuelle de sortie est défini sur Null.

Erreurs et exceptions	Notes	Exemple
L’activité de machine virtuelle Save State utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Aucun(e)	None

Activités de script

Utilisez une activité de script dans Service Manager pour exécuter un script dans le cadre d’un flux de travail.

Les activités de script sont exécutées en tant que processus séparé à partir des flux de travail ; toutefois, elles sont également exécutées sous le contexte de sécurité du compte de flux de travail Service Manager.

L’outil de création Service Manager fournit les trois activités de script par défaut suivantes dans le sous-groupe Activités de script générique du groupe Activités de script dans le volet Boîte à outils Activités des activités.

Activité de script de commande

Cette activité exécute un script de ligne de commande dans le cadre d’un flux de travail Windows Workflow Foundation (WF).

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité script de commande utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Groupe d’administration	ManagementGroupName	Chaîne	Non	Spécifie le groupe d’administration auquel appartient le serveur de script. Par défaut, cette valeur est définie sur localhost. (Lecture seule)
Paramètres de script	Paramètres	Chaîne de <dictionnaire, chaîne>	Oui	Spécifie les commutateurs de ligne de commande ou les paires switch/value à passer dans le script lorsqu’il s’exécute.
Corps du script	ScriptBody	Chaîne	Oui	Spécifie le texte du script lui-même.
Serveur de script	Cible	Chaîne	Non	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution du script.

Erreurs et exceptions	Notes	Exemple
L’activité script de commande utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Aucun(e)	None

Activité de script Windows PowerShell

Cette activité dans Service Manager exécute un script Windows PowerShell dans le cadre d’un flux de travail Windows Workflow Foundation (WF).

Conditions préalables au temps de conception	Conditions préalables à l’exécution
L’activité script Windows PowerShell dépend des prérequis suivants au moment du design : - Windows PowerShell 2.0	Windows PowerShell 2.0

Propriétés

L’activité script Windows PowerShell utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Groupe d’administration	ManagementGroupName	Chaîne	Non	Spécifie le groupe d’administration auquel appartient le serveur de script. Par défaut, cette valeur est définie sur localhost. (Lecture seule)
Paramètres de script	Paramètres	Chaîne de <dictionnaire, chaîne>	Oui	Spécifie la liste nom/valeur des paramètres à passer dans le script lorsqu’il s’exécute. Vous pouvez définir des valeurs de paramètre sur l’une des références de pack d’administration suivantes : - $Target/...$ - $MPElement[...] - $Data/...$. $Data références sont résolues uniquement au moment de l’exécution dans les paramètres (pas dans le script lui-même). L’utilisation de l’une de ces références comme seule valeur pour un paramètre définit ce paramètre sur la chaîne XML qui représente l’élément de données d’entrée (à partir de GetItemXML).
Corps du script	ScriptBody	Chaîne	Oui	Spécifie le texte du script lui-même.
Composants logiciels enfichables	SnapIns	Chaîne	Non	Répertorie les composants logiciels enfichables Windows PowerShell à précharger dans l’espace d’exécution.
Serveur de script	Cible	Chaîne	Non	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution du script.

Erreurs et exceptions	Notes	Exemple
L’activité script Windows PowerShell utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Pour plus d’informations sur Windows PowerShell, consultez Windows PowerShell.	Aucun(e)

Activité de script VBScript

Cette activité dans Service Manager exécute un script VBScript dans le cadre d’un flux de travail Windows Workflow Foundation (WF).

Conditions préalables au temps de conception	Conditions préalables à l’exécution
L’activité de script VBScript dépend des prérequis suivants au moment du design : Aucune.	Aucun(e)

Propriétés

L’activité script VBScript utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom d’affichage	Nom interne	Type	Requise	Description
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est True.)	Détermine si le flux de travail continue à s’exécuter si l’activité échoue.
A une erreur	HasError		N/A	Spécifie si l’activité a un jeu d’erreurs. (Lecture seule)
Groupe d’administration	ManagementGroupName	Chaîne	Non	Spécifie le groupe d’administration auquel appartient le serveur de script. (Par défaut, il est défini sur localhost) (en lecture seule)
Paramètres de script	Paramètres	Chaîne de <dictionnaire, chaîne>	Oui	Fournit la liste des commutateurs standard et toutes les valeurs associées que ce script utilise lorsqu’il s’exécute.
Corps du script	ScriptBody	Chaîne	Oui	Spécifie le texte du script lui-même.
Serveur de script	Cible	Chaîne	Non	Spécifie le nom DNS (Domain Name System) du serveur qui exécute la console Service Manager. N’utilisez pas localhost.
Limite de temps de script	TimeoutSeconds	Integer	Non. (Le paramètre par défaut est de 300 secondes.)	Spécifie le nombre maximal de secondes à autoriser l’exécution du script.

Erreurs et exceptions	Notes	Exemple
L’activité de script VBScript utilise le service de suivi personnalisé fourni par Service Manager pour consigner les erreurs et les exceptions lors de l’exécution de l’activité. L’activité génère des erreurs ou des exceptions selon les besoins si aucune des propriétés de script ne peut être résolue.	Aucun(e)	None

Activités de Service Manager

Utilisez les activités Service Manager dans Service Manager pour faire partie de votre workflow des fonctions Service Manager.

L’outil de création Service Manager fournit les quatre activités Service Manager par défaut suivantes dans le groupe Activités SM dans le volet Boîte à outils Activités.

Créer une activité d’incident

Cette activité crée et remplit un incident dans Service Manager.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité Créer un incident utilise les propriétés d’entrée répertoriées dans le tableau suivant.

Nom complet	Nom interne	Type	Requis	Commentaires
ID d’incident	IncidentID	Chaîne	Oui	Spécifie l’identificateur unique généré pour l’objet Incident .
Commentaire du journal des actions	ActionLogComment	Chaîne	Oui	Spécifie le commentaire à inclure dans le journal des actions de l’objet Incident .
Domaine utilisateur affecté	AffectedUserDomain	Chaîne	Oui	Spécifie le nom du domaine DNS (Domain Name System) de l’utilisateur principal affecté par l’incident.
Nom d’utilisateur affecté	AffectedUserName	Chaîne	Oui	Spécifie le nom d’utilisateur de l’utilisateur principal affecté par l’incident.
Catégorie	Catégorie	Integer	Oui	Spécifie le type d’incident, tel que la mise en réseau ou l’impression. La valeur est l’ID de l’énumération. (Champ de données de catégorie -enum )
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est true.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
Impact	Impact	Integer	Oui	Spécifie l’impact de l’incident sur l’utilisateur ou les utilisateurs concernés. La valeur est l’ID de l’énumération. (Type de données Impact -enum )
Source	Source	Integer	Non	Spécifie la source d’informations sur l’incident, telles que le téléphone ou le courrier électronique. La valeur est l’ID de l’énumération. (Champ de type de données source -enum )
Résumé	Résumé	Chaîne	Oui	Spécifie le texte récapitulative qui décrit l’incident.
Urgence	Urgence	Integer	Oui	Spécifie l’urgence de résoudre l’incident. La valeur est l’ID de l’énumération. (Champ de type de données d’énumération d’urgence)

L’activité Créer un incident génère la sortie décrite dans le tableau suivant.

Nom	Type	Commentaires
SM Incident	System.WorkItem.Incident	Retourne l’instance de classe d’incident construite.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	None	None

Obtenir l’activité d’incident

Cette activité récupère un ou plusieurs incidents dans Service Manager.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité Get Incident utilise les propriétés d’entrée répertoriées dans le tableau suivant.

Nom complet	Nom interne	Type	Requis	Commentaires
Domaine utilisateur affecté	AffectedUserDomain	Chaîne	Non	Spécifie le nom du domaine DNS (Domain Name System) de l’utilisateur principal affecté par l’incident.
Nom d’utilisateur affecté	AffectedUserName	Chaîne	Non	Spécifie le nom d’utilisateur de l’utilisateur principal affecté par l’incident.
Catégorie	Catégorie	Integer	Non	Spécifie le type d’incident, tel que la mise en réseau ou l’impression. La valeur est l’ID de l’énumération. (Champ de données de catégorie -enum )
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (La valeur par défaut est true.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
ID d’incident	IncidentID	Chaîne	Non	Spécifie l’identificateur unique généré pour l’objet incident.
Type de recherche	SearchType	Integer	Non	Spécifie le titre du type de recherche utilisé avec l’activité.
État	État	Integer	Non	Spécifie l’état de l’incident. La valeur est l’ID de l’énumération. (Champ de données Status -enum )
Texte de résumé	SummaryText	Chaîne	Non	Spécifie le texte récapitulative qui décrit l’incident.

L’activité Get Incident génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Commentaires
SM Incidents	SMIncidents	Tableau de System.Workitem.Incident	Spécifie un tableau d’objets incidents.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	L’activité Get Incident a son propre validateur pour effectuer la validation d’erreur sur les propriétés d’entrée.	Aucun(e)

Mettre à jour l’activité incident

Cette activité dans Service Manager enregistre les modifications de propriété apportées à un incident Service Manager.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	None

Propriétés

L’activité Update Incident utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
Commentaire du journal des actions	ActionLogComment	Chaîne	Non	Spécifie un commentaire à inclure dans le journal des actions de l’objet Incident.
Domaine utilisateur affecté	AffectedUserDomain	Chaîne	Non	Spécifie le nom du domaine DNS (Domain Name System) de l’utilisateur principal affecté par l’incident.
Nom d’utilisateur affecté	AffectedUserName	Chaîne	Non	Spécifie le nom d’utilisateur de l’utilisateur principal affecté par l’incident.
Catégorie	Catégorie	Integer	Non	Spécifie le type d’incident, tel que la mise en réseau ou l’impression. La valeur est l’ID de l’énumération. (Type de données Category -enum )
Continuer sur l’erreur	ContinueOnError	Boolean	Non. (Le paramètre par défaut est true.)	Détermine si le flux de travail doit continuer à s’exécuter en cas d’échec de l’activité.
Impact	Impact	Integer	Non	Spécifie l’impact de l’incident sur l’utilisateur ou les utilisateurs concernés. La valeur est l’ID de l’énumération. (Type de données Impact -enum )
Source	Source	Integer	Non	Spécifie la source d’informations sur l’incident, telles que le téléphone ou le courrier électronique. La valeur est l’ID de l’énumération. (Type de données source -enum )
Service Manager Incident	SMIncident	System.Workitem.Incident	Non	Instance de classe d’incident construite à mettre à jour.
État	État	Integer	Non	Spécifie l’état de l’incident qui a généré l’activité. La valeur est l’ID de l’énumération. (Type de données Status -enum )
Résumé	Résumé	Chaîne	Non	Spécifie le texte récapitulative qui décrit l’incident.
Urgence	Urgence	Integer	Non	Spécifie l’urgence de résoudre l’incident. La valeur est l’ID de l’énumération. (Champ de type de données d’énumération d’urgence)

L’activité Update Incident génère la sortie décrite dans le tableau suivant.

Nom complet	Nom interne	Type	Description
SM Incident	SMIncident	System.WorkItem.Incident	Retourne une mise à jour de l’instance de classe d’incident. L’incident SM d’entrée et l’incident SM de sortie sont égaux, sauf si l’activité n’a pas trouvé l’incident SM. Dans ce cas, l’incident sm de sortie est défini sur Null.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	None	None

Définir l’état de l’activité sur l’activité terminée

Cette activité met à jour l’état d’une activité automatisée dans Service Manager.

Conditions préalables au temps de conception	Conditions préalables à l’exécution
Aucun(e)	Aucune.

Propriétés

L’état de l’activité Définir l’activité sur Terminé utilise les propriétés d’entrée décrites dans le tableau suivant.

Nom complet	Nom interne	Type	Requise	Description
ID d’activité	ActivityID	Chaîne	Oui	Spécifie l’identificateur d’un objet d’activité automatisé Service Manager.

Erreurs et exceptions	Notes	Exemple
Aucun(e)	Lorsque vous utilisez cette activité dans un flux de travail déclenché par une activité automatisée Service Manager, entrez $Data/BaseManagedEntityId$ comme valeur de cette propriété. Cette valeur s’applique à l’activité Définir l’état de l’activité sur l’activité terminée au niveau de l’activité automatisée qui a déclenché l’exécution du flux de travail.	Aucun(e)