Freigeben über


New-SCSMWorkflow

Erstellt einen neuen Workflow in Service Manager.

Syntax

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>]

Beschreibung

Das Cmdlet New-SCSMWorkflow erstellt einen Workflow in Service Manager.

Beispiele

Beispiel 1: Erstellen eines Workflows für die erstellung manueller Aktivitäten

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

Der erste Befehl ruft eine Vorlage mit dem Namen DefaultManualActivityTemplate mithilfe des cmdlets Get-SCSMObjectTemplate ab. Der Befehl speichert die Vorlage in der variablen $Template.

Der zweite Befehl erstellt ein Array von Benachrichtigungen als Hashtabellen und speichert sie in der variablen $Notification.

Der letzte Befehl erstellt einen Workflow, der verwendet werden kann, wenn eine manuelle Aktivität erstellt wird. Da das Skript keine Kriterien angibt, gilt dieser Workflow für jede Erstellung einer manuellen Aktivität.

Beispiel 2: Erstellen eines Workflows für die manuelle Aktivitätserstellung für einen Benutzer

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

Der erste Befehl erstellt eine Kriterienzeichenfolge, die für die manuelle Aktivität definiert ist, um nur die manuellen Aktivitäten auszuwählen, die vom Benutzer Evan Narvaez erstellt wurden. Der Befehl speichert diese Kriterien in der variablen $CriteriaString.

Der zweite Befehl ruft das Management Pack namens Workflows mithilfe des Cmdlets Get-SCSMManagementPack ab und speichert es dann in der $ManagementPack Variablen. Ein nachfolgender Befehl verwendet diesen Wert, um anzugeben, wo der Workflow gespeichert werden soll. Dies darf kein versiegeltes Management Pack sein.

Der dritte Befehl ruft eine Vorlage mit dem Namen DefaultManualActivityTemplate mithilfe des cmdlets Get-SCSMObjectTemplate ab. Der Befehl speichert die Vorlage in der variablen $Template.

Der vierte Befehl erstellt ein Array von Benachrichtigungen als Hashtabellen und speichert sie in der variablen $Notification.

Der letzte Befehl erstellt einen Workflow, der verwendet werden kann, wenn eine manuelle Aktivität erstellt wird.

Parameter

-Class

Gibt den Namen der Klasse an, die den Workflow startet, wenn er geändert wird. Gültige Werte sind:

  • Konfiguration
  • Veränderung
  • Vorfall
  • ManualActivity
  • ReviewActivity
  • DeploymentActivity
Typ:System.String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt den Namen des Computers an, auf dem der System Center Data Access-Dienst ausgeführt wird. Das benutzerkonto, das im parameter Credential angegeben ist, muss über Zugriffsrechte für den angegebenen Computer verfügen.

Typ:System.String[]
Position:Named
Standardwert:Localhost
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:System.Management.Automation.SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt die Anmeldeinformationen an, die dieses Cmdlet zum Herstellen einer Verbindung mit dem Server verwendet, auf dem der System Center Data Access-Dienst ausgeführt wird. Das angegebene Benutzerkonto muss über Zugriffsrechte für diesen Server verfügen.

Typ:System.Management.Automation.PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Criteria

Gibt ein Objekt an, das Kriterien zum Einschränken des Resultsets darstellt.

Typ:System.String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für den Workflow an.

Typ:System.String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt den Namen des zu erstellenden Workflows an.

Typ:System.String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Enable

Gibt an, ob dieses Cmdlet den Workflow aktiviert oder deaktiviert.

Typ:System.Boolean
Position:Named
Standardwert:True
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableNotification

Gibt an, ob dieses Cmdlet Benachrichtigungen vom Workflow aktiviert oder deaktiviert.

Typ:System.Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Event

Gibt die Bedingung an, unter der der Workflow gestartet wird. Gültige Werte sind:

  • Schaffen
  • Aktualisieren
Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Zulässige Werte:Create, Update
Position:Named
Standardwert:Created
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManagementPack

Gibt das Management Pack an, in dem der Workflow gespeichert werden soll. Geben Sie kein versiegeltes Management Pack an.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Standardwert:The default management pack
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Notification

Gibt eine Hashtabelle von Benutzern und Vorlagen an, die für Benachrichtigungen aus dem Workflow verwendet werden sollen.

Typ:System.Collections.Hashtable[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt an, dass dieses Cmdlet den Workflow zurückgibt, den dieses Cmdlet erstellt. Sie können dieses Objekt an andere Cmdlets übergeben.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt ein Objekt an, das eine Sitzung auf einem Dienst-Manager-Verwaltungsserver darstellt.

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Template

Gibt die Vorlage an, die auf die Objekte angewendet werden soll, die sich auf den Workflow auswirken.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:System.Management.Automation.SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None.

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

None.

Dieses Cmdlet generiert keine Ausgabe.