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.