Partager via

New-SCSMWorkflow

  • Référence
Module:
System.Center.Service.Manager

Crée un flux de travail dans Service Manager.

Syntaxe

New-SCSMWorkflow
   -Class <String>
   [-DisplayName] <String>
   [-Description <String>]
   [-Enable <Boolean>]
   [-Event <WorkflowEvent>]
   [-ManagementPack <ManagementPack>]
   [-Criteria <String>]
   [-Template <ManagementPackObjectTemplate>]
   [-EnableNotification <Boolean>]
   [-Notification <Hashtable[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-SCSMWorkflow crée un flux de travail dans Service Manager.

Exemples

Exemple 1 : Créer un flux de travail pour la création d’activités manuelles

PS C:\>$Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name "AssignedToUserNotificationTemplate" },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 07" -Class "ManualActivity" -Description "Contoso workflow 07." -Enable $True -Event Create -Notification $Notification -Template $Template

La première commande obtient un modèle nommé DefaultManualActivityTemplate à l’aide de l’applet de commande Get-SCSMObjectTemplate. La commande stocke le modèle dans la variable $Template.

La deuxième commande crée un tableau de notifications en tant que tables de hachage et les stocke dans la variable $Notification.

La commande finale crée un flux de travail qui peut être utilisé lors de la création d’une activité manuelle. Étant donné que le script ne spécifie aucun critère, ce flux de travail s’applique à toute création d’une activité manuelle.

Exemple 2 : Créer un flux de travail pour la création d’activités manuelles pour un utilisateur

PS C:\>$CriteriaString = @'
>>  <Criteria>
>>   <Expression>
>>    <SimpleExpression>
>>     <ValueExpression>
>>      <Property State="Post">
>>  $Context/$Path[Relationship='System.WorkItem.Library!System.WorkItemCreatedByUser' TypeConstraint='System!System.Domain.User']/Property[Type='System!System.Domain.User']/UserName$
>>      </Property>
>>     </ValueExpression>
>>     <Operator>Equal</Operator>
>>     <ValueExpression>
>>      <Value>Evan Narvaez</Value>
>>     </ValueExpression>
>>    </SimpleExpression>
>>   </Expression>
>>  </Criteria>
>>  '@
PS C:\> $ManagementPack = Get-SCSMManagementPack -Name "Workflows"
PS C:\> $Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name AssignedToUserNotificationTemplate },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 09" -Class "ManualActivity" -Criteria $CriteriaString -Description "Contoso workflow 09." -Enable $False -Event Create -ManagementPack $ManagementPack -Template $Template

La première commande crée une chaîne de critères définie pour l’activité manuelle pour sélectionner uniquement les activités manuelles créées par l’utilisateur Evan Narvaez. La commande stocke ces critères dans la variable $CriteriaString.

La deuxième commande obtient le pack d’administration nommé Workflows à l’aide de l’applet de commande Get-SCSMManagementPack, puis le stocke dans la variable $ManagementPack. Une commande suivante utilise cette valeur pour spécifier où enregistrer le flux de travail. Il ne doit pas s’agir d’un pack d’administration scellé.

La troisième commande obtient un modèle nommé DefaultManualActivityTemplate à l’aide de l’applet de commande Get-SCSMObjectTemplate. La commande stocke le modèle dans la variable $Template.

La quatrième commande crée un tableau de notifications sous forme de tables de hachage et les stocke dans la variable $Notification.

La commande finale crée un flux de travail qui peut être utilisé lors de la création d’une activité manuelle.

Paramètres

-Class

Spécifie le nom de la classe qui démarre le flux de travail lorsqu’il change. Les valeurs valides sont les suivantes :

  • Configuration
  • Changement
  • Incident
  • ManualActivity
  • ReviewActivity
  • DeploymentActivity
Type:System.String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ComputerName

Spécifie le nom de l’ordinateur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié dans le paramètre Credential doit avoir des droits d’accès à l’ordinateur spécifié.

Type:System.String[]
Position:Named
Valeur par défaut:Localhost
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:System.Management.Automation.SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie les informations d’identification que cette applet de commande utilise pour se connecter au serveur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié doit avoir des droits d’accès à ce serveur.

Type:System.Management.Automation.PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Criteria

Spécifie un objet qui représente des critères pour restreindre le jeu de résultats.

Type:System.String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description du flux de travail.

Type:System.String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie le nom du flux de travail à créer.

Type:System.String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Enable

Indique si cette applet de commande active ou désactive le flux de travail.

Type:System.Boolean
Position:Named
Valeur par défaut:True
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableNotification

Indique si cette applet de commande active ou désactive les notifications du flux de travail.

Type:System.Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Event

Spécifie la condition dans laquelle le flux de travail démarre. Les valeurs valides sont les suivantes :

  • Créer
  • Mettre à jour
Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Valeurs acceptées:Create, Update
Position:Named
Valeur par défaut:Created
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManagementPack

Spécifie le pack d’administration dans lequel stocker le flux de travail. Ne spécifiez pas de pack d’administration scellé.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Valeur par défaut:The default management pack
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Notification

Spécifie une table de hachage d’utilisateurs et de modèles à utiliser pour les notifications du flux de travail.

Type:System.Collections.Hashtable[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Indique que cette applet de commande retourne le flux de travail créé par cette applet de commande. Vous pouvez transmettre cet objet à d’autres applets de commande.

Type:System.Management.Automation.SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SCSession

Spécifie un objet qui représente une session sur un serveur d’administration Service Manager.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Template

Spécifie le modèle à appliquer aux objets affectés par le flux de travail.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:System.Management.Automation.SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None.

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

None.

Cette applet de commande ne génère aucune sortie.